Cookdata · Koda Core API

Documentación de la API

Acceso unificado y seguro a los datos de Cookdata para integraciones externas, ERPs, y herramientas de análisis.

REST · JSON HTTPS · TLS 1.3 API Key auth Paginación estándar

Base URL

Todas las peticiones deben dirigirse a la siguiente URL base:

https://kodacoreconnect.cookdata.io

La versión actual de la API es v1. Los endpoints dinámicos se sirven bajo /api/v1/q/.

Autenticación

La API usa API Keys enviadas en la cabecera HTTP X-API-Key. Las keys se generan desde el panel de administración y están asociadas a un cliente.

Cabecera requerida en todas las peticiones

X-API-Key: koda_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Seguridad: Las API Keys se almacenan hasheadas (SHA-256). Si pierdes una key deberás revocarla y generar una nueva desde el panel.

Ejemplo con curl

# Llamada básica con autenticación
curl -H "X-API-Key: koda_tu_key_aqui" \
     https://kodacoreconnect.cookdata.io/api/v1/q/a3rp/sync

Endpoints disponibles

Los endpoints se configuran dinámicamente desde el panel de administración. Esta lista se actualiza en tiempo real.

No hay endpoints públicos configurados aún.

Health check

GET /health No requiere autenticación
{
  "status": "ok",
  "env":    "production"
}

Códigos de error

CódigoSignificadoCausa habitual
401No autenticadoFalta la cabecera X-API-Key o la key es inválida/revocada
403Sin permisoLa key no tiene acceso a ese endpoint específico
404No encontradoEl path del endpoint no existe o está inactivo
400Parámetro inválidoFiltro requerido ausente o valor con formato incorrecto
429Rate limitDemasiadas peticiones por minuto
500Error internoProblema de conexión con la base de datos del cliente

Formato de error

{
  "detail": "Invalid API key"
}