Introducción a la API de CES

La API de CES expone los recursos del ecosistema —productos, dominios, clientes y eventos— mediante una interfaz REST con respuestas JSON. Todas las peticiones se hacen sobre HTTPS a la URL base:

https://api.ces.example/v0

La URL definitiva se anunciará con la primera versión pública.

Las peticiones se autentican con una API key en la cabecera Authorization. Crea y revoca claves desde la consola de desarrolladores.

curl https://api.ces.example/v0/me \
  -H "Authorization: Bearer ces_test_…"

Nunca incluyas claves en código del lado del cliente ni en repositorios públicos.

Los errores usan códigos HTTP estándar y un cuerpo con formato uniforme:

{
  "error": {
    "type": "invalid_request",
    "message": "El campo 'name' es obligatorio.",
    "param": "name"
  }
}

Los listados usan paginación por cursor con los parámetros limit y starting_after. La respuesta incluye has_more.