DocumentationIdempotency

Idempotency

Safe retries for POST requests.

Idempotency prevents duplicate work when you retry a request.

How it works

Send an Idempotency-Key header with your request. The API will return the original response for up to 24 hours.

curl -X POST https://api.ssapi.com/v1/capture \
  -H "Content-Type: application/json" \
  -H "X-Access-Key: your-key" \
  -H "Idempotency-Key: 7f9f6f1c-53b1-4df6-9a4a-8a2c6e1c1f02" \
  -d '{"url":"https://example.com"}'

Best practices

  • Use a UUID per request.
  • Keep the request body identical for a given key.
  • Use idempotency for retries after network timeouts.
Updated 1 day ago
Did this page help you?