Plataforma
API REST
El API REST de Azter está en desarrollo. No publicamos endpoints hasta que existen: esta página describe los principios con los que se construye y cómo encajará con lo que ya puedes usar hoy.
Estado
Capability CoreDisponibleEl núcleo canónico ya opera en producción y es la fuente del API.
REST /v1En desarrolloPrivate preview con partners antes del acceso general.
OpenAPIPlaneadoLa especificación se generará desde el Capability Registry.
Principios del API
- Mismo Capability Core: el API no implementa lógica propia; invoca las mismas capabilities canónicas que el runtime del agente y MCP.
- Mismos scopes: los permisos son los de la referencia de capabilities, sin una capa de autorización distinta.
- Idempotencia explícita: los endpoints mutativos aceptarán un header Idempotency-Key con la semántica de intento lógico.
- Contract-first: la especificación OpenAPI se generará desde el registry, no se escribirá a mano.
Cómo será
Mientras llega el acceso general, estas son las superficies reales disponibles hoy y las planeadas:
MCPDisponible
10 herramientas en producción con OAuth 2.1 y API keys.
WebhooksDisponible
Eventos firmados con HMAC y reintentos con backoff.
REST /v1Planeado
Endpoints JSON sobre el mismo core, con OpenAPI generado.
Private preview
Habrá un periodo de private preview con partners antes de la apertura general. El anuncio y la documentación de endpoints llegarán aquí cuando el servicio exista.
Shape de referencia
El catálogo canónico machine-readable ya publica la forma de cada capability — la misma que consumirá el API:
terminal
curl -s https://azter.ai/docs/capabilities.json | jq '.capabilities[0]'Sin endpoints ficticios — lo que no existe no se documenta.