ConverterHQDevelopers
API v1

API-conventies

HTTP-regels, IDs, paginering, tijd en headers voor API v1.

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.