Referencia de API

Cada endpoint de esta referencia es una solicitud POST a https://api.croma.run, autenticada con una llave de API de tipo bearer. Elige un endpoint en la barra lateral para ver su esquema completo, una solicitud de ejemplo y un playground de “pruébalo”.

​

Países soportados

Los endpoints se agrupan por país, y cada país tiene su propio prefijo de ruta: GET /jobs/{id} no depende del país: devuelve el estado de cualquier trabajo asíncrono.

​

Convenciones

• Auth: Authorization: Bearer <key> en cada endpoint. Consulta Autenticación.
• Éxito: las respuestas envuelven la carga útil bajo data: { "data": … }.
• Errores: { "error": { "type", "code", "message" } } con un estado distinto de 2xx. Consulta Errores.
• Sin coincidencia: un registro consultado que no existe es un 200, no un 404: las consultas de un solo registro devuelven found: false y las consultas de lista devuelven un arreglo vacío.
• Límites de tasa: se reportan mediante los encabezados de respuesta X-RateLimit-*. Consulta Límites de tasa.
• Trabajos asíncronos: las consultas de larga duración pueden devolver un 202 con un trabajo que puedes consultar por polling o recibir vía callback. Consulta la lista en Trabajos asíncronos.