Robuuste integraties vertrouwen op stabiele conventies voor status, opaque IDs, cursors en requestmetadata in plaats van toevallige endpointdetails.
HTTP en statuscodes
Asynchrone creates geven 202 Accepted zolang werk doorgaat; succesvolle reads 200. Fouten volgen Problem Details met een stabiele machine-code.
IDs en tijd
Behandel file_..., job_..., task_... en project_id als opaque strings. Timestamps zijn ISO 8601 UTC; leid geen betekenis af uit de sortering van IDs.
Cursorpaginering
Lijsten gebruiken opaque cursors. Stuur next_cursor ongewijzigd door, behoud filters en maak nooit zelf een cursor.
Operationele headers
Stuur Idempotency-Key bij replaybare creates en bewaar X-Request-ID. Respecteer Retry-After en RateLimit-* voor retries.