Fouten en idempotentie
Standaardfouten, retries, limieten en duplicaatpreventie.
Fouten gebruiken application/problem+json, de echte HTTP-status en request_id.
Creaties vereisen een Idempotency-Key van 8–128 tekens. Alleen HMAC en verzoekvingerafdruk worden bewaard. Dezelfde Key/body geeft de oorspronkelijke taak; andere body geeft 409 idempotency_conflict; lopend verzoek geeft 409 request_in_progress. Genereer geen nieuwe Key in automatische retries.
Veelvoorkomende codes: invalid_api_key, invalid_api_key_rate_limited, api_key_expired, insufficient_scope, validation_error, unsupported_model, unsupported_parameter, input_url_not_allowed, insufficient_credits, payment_required, account_suspended, network_not_allowed, rate_limit_exceeded, concurrency_limit_exceeded, provider_unavailable, service_unavailable.
Herhaald ongeldige referenties vanaf hetzelfde IP worden beperkt; alleen een met Pepper HMAC beschermde IP-vingerafdruk wordt opgeslagen.
Netwerkfouten, 429, 503 met backoff, dezelfde body en Key opnieuw proberen. Bij een onzekere Provider-uitkomst weigert de API blind opnieuw indienen.
Respecteer vóór elke nieuwe poging altijd de header Retry-After.