API de la plataforma (/v1)
La API de la plataforma es la interfaz HTTP versionada de Waafir. Utilícela para consultar y gestionar su organización desde sus propios sistemas. Cubre su equipo (invitar a miembros, cambiar roles, dar de baja), las concesiones de acceso a salas de datos, carpetas, archivos, preguntas y respuestas, el chat y los agentes de la sala de datos, la actividad y la participación por contraparte, y el seguimiento de cartera.
Es una superficie distinta de los servidores MCP de Waafir, que exponen la misma plataforma a los clientes de IA como herramientas. Ambos se autentican con los mismos tokens de acceso personal.
URL base
Todos los endpoints se encuentran bajo:
https://app.waafir.io/api/v1La referencia de endpoints enumera cada uno por
su ruta completa, por ejemplo GET /api/v1/team.
Su primera llamada
- Emita un token. En Waafir, abra Complementos → Configuración y emita
un token de acceso personal. Para empezar basta con un token
read. Copie el valor, que empieza porwaafir_pat_. Solo se muestra una vez. - Pregunte quién es.
GET /api/v1/sessiondevuelve la identidad y la organización en cuyo nombre actúa el token. Utilícelo para comprobar que un token funciona antes de construir sobre él:
curl -s https://app.waafir.io/api/v1/session \
-H "Authorization: Bearer $WAAFIR_TOKEN"{
"orgId": "…",
"userId": "…",
"email": "you@example.com",
"orgRole": "admin",
"authMethod": "pat",
"principalType": "user"
}Un 401 significa que el token falta, está mal escrito, ha caducado o se ha
revocado. Los demás rechazos suelen incluir un code legible por máquina, que
se explica en la página de códigos de error.
Algunos no incluyen ninguno, así que recurra siempre al estado HTTP.
Cómo se genera la referencia
Las páginas de endpoints y de códigos de error se generan a partir del propio árbol de rutas de la plataforma cada vez que se publica este sitio. No se escriben a mano. Una versión de producción las genera a partir del mismo commit que la aplicación, de modo que enumeran las rutas que sirve esa versión, con el control de rol y el alcance de token que requiere cada endpoint y los parámetros de consulta que acepta. Sus listas de errores son un mínimo conocido, no exhaustivo: un endpoint puede devolver códigos que el generador no ve, así que gestione los errores no enumerados según el estado HTTP.
Control de versiones
/v1 es aditiva dentro de su versión. Waafir puede añadir campos de respuesta
y parámetros de solicitud opcionales. No elimina ni cambia el tipo de un campo
existente, ni elimina un endpoint, dentro de /v1. Un cambio incompatible se
publica bajo un nuevo prefijo de versión. Escriba clientes que ignoren los
campos que no reconozcan.
Adónde ir a continuación
- Autenticación: tokens, alcances, el techo de rol y los tokens restringidos a salas de datos.
- Endpoints: todos los endpoints, agrupados por área.
- Códigos de error: los rechazos conocidos y qué hacer al respecto.
- Referencia de la API de préstamos y el recetario: el contrato de solicitud y respuesta para la ingesta de datos de seguimiento de cartera.