Superficies de la API

Las operaciones no se sirven todas desde el mismo host. La API pública y el panel comparten el código pero exponen conjuntos distintos, y una operación que no pertenece al conjunto de un host responde 404 en él aunque las credenciales sean válidas.

Las 129 de la API pública también responden en el panel; las 478 restantes son exclusivas del panel: 409 son del plano de administración y el resto, de la sesión y la cuenta.

Cómo saber a cuál pertenece una operación

Cada página de referencia lo declara. Dos indicadores lo determinan:

• Visibilidad — public o admin. Las admin no aparecen en la referencia pública.
• Método de autenticación — una operación que solo acepta sesión de navegador no está pensada para integrarse desde código, aunque exista.

Diagnóstico de un 404 inesperado

Un 404 sobre una ruta que la documentación describe suele significar que la operación no pertenece a la superficie que se está invocando, no que la ruta no exista. Es la confusión más costosa al integrar, porque el código de estado sugiere un error de ruta cuando el problema es de host.

Antes de revisar la ruta conviene comprobar la superficie declarada en su página de referencia. Si la operación es exclusiva del panel, no hay credencial que la haga responder en el host de la API.

Versión

Todas las rutas cuelgan de /v1. La familia de rutas que atendió la petición viaja en meta.api_version de cada respuesta, según describe la forma de las respuestas.