Guía de autenticación para la API de Waclis Inbox

Elegir el tipo de credencial y enviarla sin exponerla.

Requisitos previos

• Identificar si la ruta es de cuenta, plataforma, pública o MCP.

Permisos y disponibilidad

La interfaz utilizada para esta documentación fue observada con un usuario Administrador. La configuración de integraciones, importaciones, servidores MCP y credenciales requiere permisos administrativos. El acceso mediante API depende del tipo de token y del alcance autorizado para la solicitud.

Ruta de acceso

API de Waclis Inbox

Procedimiento

1. Consulta la carpeta o referencia del endpoint.
2. Utiliza token de cuenta para rutas autorizadas de una cuenta.
3. Utiliza credencial de aplicación de plataforma solo en rutas de plataforma.
4. No envíes token en parámetros de URL.
5. Almacena la credencial como secreto.
6. Prueba con una solicitud de lectura.
7. Trata 401 y 403 como problemas diferentes.

Campos y opciones

| Elemento | Descripción | |---|---| | Token de cuenta | Autoriza operaciones de la cuenta según usuario y permisos. | | Token de aplicación | Autoriza operaciones propias de una aplicación de plataforma. | | Ruta pública | No requiere credencial, pero puede tener validaciones y límites. | | OAuth Bearer MCP | Token obtenido por el flujo OAuth. | | Api-Access-Token MCP | Alternativa estática admitida por el servidor MCP. |

Ejemplos

Solicitud de cuenta

curl --request GET \
  --url '{{base_url}}/api/v1/accounts/{{account_id}}/recurso' \
  --header 'api_access_token: {{account_token}}'

Resultado esperado

Puedes aplicar la configuración o solicitud con parámetros y credenciales controlados.

Artículos relacionados

• Cómo utilizar la colección Postman de la API
• Referencia de códigos de respuesta y errores de API
• Cómo conectarse a un servidor MCP mediante JSON-RPC
• Cómo rotar tokens y proteger una integración API