Waafir
Esta página es una traducción automática pendiente de revisión humana. Puede contener errores.

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/v1

La referencia de endpoints enumera cada uno por su ruta completa, por ejemplo GET /api/v1/team.

Su primera llamada

  1. 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 por waafir_pat_. Solo se muestra una vez.
  2. Pregunte quién es. GET /api/v1/session devuelve 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