API de Amazi
Descripción general
Conecte su servidor o automatización a Amazi con API v1.
Base URL
La base Amazi API URL es https://api.amazi.ai/v1. Enviar solicitudes a través de HTTPS. Las páginas de referencia muestran rutas completas como /v1/plans; agregue esas rutas a https://api.amazi.ai sin un prefijo /api adicional o un segundo /v1.
Referencia interactiva
Abra la referencia API v1 para inspeccionar puntos finales, parámetros y esquemas de respuesta, o descargue la OpenAPI JSON. Ambos se pueden leer sin iniciar sesión y contienen solo el archivo externo /v1 API.
Para probar las solicitudes de chat del proyecto, elija Autorizar → userApiTokenBearer e ingrese su token API personal. Las lecturas de datos públicos no necesitan token. Pruébalo envía solicitudes reales: crear chats o enviar mensajes cambia tu proyecto y puede usar créditos. Swagger conserva el token solo hasta que recargas la página.
Elige un recurso
| Guía | que puedes hacer | Autenticación |
|---|---|---|
| Autenticación | Crear y revocar tokens API personales | La sesión de tu cuenta gestiona tokens |
| Chats del proyecto | Listar, crear, renombrar, archivar y restaurar chats; leer y enviar mensajes | Ficha personal API |
| Datos públicos | Leer planes, documentos legales, pancartas y el cuestionario. | Ninguno |
Las solicitudes de chat del proyecto utilizan los permisos de su cuenta actual y las reglas de crédito normales. El envío de un mensaje regresa después de la aceptación; siga su cola e historial para ver el resultado.
Primera solicitud
Lea el catálogo de planes sin token:
Para enviar un mensaje, primero [crea un token](doc:amazi-api-authentication), luego sigue el [ejemplo de chat del proyecto](doc:amazi-api-chats). La gestión de tokens utiliza /auth/api-tokens en el origen API, fuera de /v1.
## Disponibilidad y reintentos
Durante una actualización de Amazi API, las solicitudes pueden devolver HTTP 503 con el código **SYSTEM_MAINTENANCE** y un encabezado **Retry-After** en segundos. Espere antes de volver a intentarlo; mantenga la misma clave de reintento al volver a enviar un mensaje. Las direcciones de proyectos publicadas siguen estando disponibles, pero es posible que las funciones del proyecto que llaman al API de Amazi también deban esperar.
Las URL del catálogo /public/... anteriores se han movido a /v1/... y devuelven HTTP 404. Utilice las rutas en [Datos públicos](doc:amazi-api-public-data).
Para servicios conectados dentro de un proyecto, consulte [Integraciones y entorno](doc:integrations-and-environment), [GitHub sincronización](doc:github-sync) y [Amazi AI Gateway](doc:ai-gateway).