Zonas de autorización y acceso
Acceso mediante enlace
Tu servidor llama a POST /v1/auth/login-link con X-API-Key y X-Customer-ID. Indica mailbox_id para abrir solo ese buzón; omítelo para abrir toda la cuenta. locale selecciona el idioma de la interfaz.
La respuesta contiene login_url, expires_in=300, expires_at (UTC), account_id y mailbox_id. El botón «Abrir correo» abre login_url completo, incluido #token. El enlace dura 5 minutos y permite un solo uso. No lo guardes en registros ni expongas la clave API en el navegador.
La página de acceso elimina el token de la barra de direcciones y lo canjea por cookies HttpOnly. Si falla o caduca, crea otro enlace. Se vuelven a comprobar los permisos y el estado de la cuenta y del buzón. Las sesiones de usuario no pueden crear enlaces.
curl https://adapt-mail.com/v1/auth/login-link \ -H "X-API-Key: <mail-api-key>" \ -H "X-Customer-ID: <mail-account-id>" \ -H "Content-Type: application/json" \ --data '{"mailbox_id":42,"locale":"en"}'
{ "login_url": "https://adapt-mail.com/auth/#token=<one-time-token>", "expires_in": 300, "expires_at": "2026-10-20T12:05:00Z", "account_id": 123, "mailbox_id": 42}Clave de socio
Utilice la clave de correo API- de su integración. Páselo a X-API-Key y ID de la cuenta de correo; en el encabezado requerido X-Customer-ID.. Este es el ID de la cuenta, no el external_id ni el ID del buzón. La clave permite el acceso sólo a los clientes de su integración.
Guarde la clave en el servidor de su socio. No coloque la clave de integración compartida en el navegador o la aplicación móvil.
curl 'https://adapt-mail.com/v1/mailboxes' \ -H 'X-API-Key: <mail-api-key>' \ -H 'X-Customer-ID: <mail-account-id>'token de usuario
POST /v1/auth/token acepta login, password y mode.. Para mode=account se utiliza el inicio de sesión user-ID, para mode=mailbox se utiliza la dirección completa del buzón. Las contraseñas de cuenta y buzón son independientes.
La respuesta contiene access_token, token_type=Bearer y expires_in=3600.. El token de la cuenta abre sus casillas; ficha de caja: solo una caja. Después del vencimiento, recibirá un nuevo token.
POST /v1/auth/tokenContent-Type: application/json
{"login":"user-123","password":"<password>","mode":"account"}
GET /v1/mailboxesAuthorization: Bearer <access_token>Sesiones de navegador
POST /v1/auth/login es para su propio sitio adapt-mail.com. Requiere el Origin correcto e instala HttpOnly cookies. Sin clasificar X-Mail-Session selecciona una de las entradas guardadas, pero sin cookie no da acceso.
Para la interfaz de terceros, utilice su servidor y token de usuario. No cuente con acceso aleatorio entre dominios desde cookie: public CORS para ningún sitio no.