Idempotency
Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.
Idempotency
Section titled “Idempotency”To prevent accidental duplicate operations—such as sending the same fax twice or paying for the same invoice twice—AgentBureau requires the Idempotency-Key header for all priced requests.
Mandatory Header
As of the latest protocol update, the Idempotency-Key is mandatory. Requests to priced endpoints without this header will be rejected with a 400 Bad Request.
How it works
Section titled “How it works”You must include an Idempotency-Key header with a unique string (we recommend a UUID v4) in your POST requests. This key is used by the gateway to generate a deterministic intent_id for the x402 flow.
POST /v1/faxIdempotency-Key: 550e8400-e29b-41d4-a716-446655440000PAYMENT-SIGNATURE: 0x...If the server receives a second request with the same Idempotency-Key within a 24-hour window, it will return the cached response of the first request instead of executing the operation again.
Retries and Network Failures
Section titled “Retries and Network Failures”Idempotency keys are essential for safely retrying requests that may have timed out or failed due to network issues. If you don’t receive a response, you can safely retry the request with the same Idempotency-Key.
Relation to x402
Section titled “Relation to x402”While the Idempotency-Key prevents duplicate processing of the same request, the PAYMENT-SIGNATURE (transaction hash) also provides a layer of replay protection. A transaction hash can only be used successfully once across the entire AgentBureau platform.