VaultTech API v2 Reference

Predictable JSON endpoints, idempotent mutations, and HMAC-SHA256 webhook verification.

Authentication

Bearer Token & Idempotency

Authenticate API requests using HTTP Bearer credentials scoped to your environment. Include an Idempotency-Key header on every POST request to safely retry transient network drops.

GET /api/telemetry.php HTTP/1.1
Host: vault.pwnedbox.site
Accept: application/json

// 200 OK
{
  "service": "vaulttech-gateway",
  "status": "operational",
  "version": "4.2.1",
  "region": "us-east-1"
}
Webhook Security

Verify Cryptographic Event Signatures

VaultTech signs every asynchronous settlement event with an HMAC-SHA256 digest in the VaultTech-Signature header to prevent replay or payload tampering.

$sig = hash_hmac('sha256', "$timestamp.$rawBody", $webhookSecret);
if (!hash_equals($expectedSig, $sig)) {
    http_response_code(400);
    exit;
}