Áreas de autorização e acesso
Entrar por link
Seu servidor chama POST /v1/auth/login-link com X-API-Key e X-Customer-ID. Informe mailbox_id para abrir apenas essa caixa; omita o campo para abrir toda a conta. locale seleciona o idioma da interface.
A resposta contém login_url, expires_in=300, expires_at (UTC), account_id e mailbox_id. O botão “Abrir e-mail” abre login_url completo, incluindo #token. O link vale por 5 minutos e só pode ser usado uma vez. Não o registre em logs nem exponha a chave API no navegador.
A página de login remove o token da barra de endereços e o troca por cookies HttpOnly. Em caso de erro ou expiração, crie um novo link. O escopo de acesso e o estado da conta e da caixa são verificados novamente. Sessões de usuário não podem criar links.
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}Chave do parceiro
Use o mail API-key da sua integração. Passe para X-API-Key e ID da conta de e-mail - no cabeçalho obrigatório X-Customer-ID. Este é ID da conta, não external_id e não ID da caixa de correio. A chave permite acesso apenas aos clientes da sua integração.
Armazene a chave no servidor do seu parceiro. Não coloque a chave de integração compartilhada no navegador ou aplicativo móvel.
curl 'https://adapt-mail.com/v1/mailboxes' \ -H 'X-API-Key: <mail-api-key>' \ -H 'X-Customer-ID: <mail-account-id>'Token do usuário
POST /v1/auth/token aceita login, password e mode. Para mode=account é usado o login user-ID, para mode=mailbox é usado o endereço completo da caixa de correio. As senhas da conta e da caixa de correio são independentes.
A resposta contém access_token, token_type=Bearer e expires_in=3600. O token da conta abre suas caixas; token de caixa - apenas uma caixa. Após a expiração, você receberá um novo token.
POST /v1/auth/tokenContent-Type: application/json
{"login":"user-123","password":"<password>","mode":"account"}
GET /v1/mailboxesAuthorization: Bearer <access_token>Sessões do navegador
POST /v1/auth/login é para site próprio adapt-mail.com. Requer o Origin correto e instala HttpOnly cookies. Não classificado X-Mail-Session seleciona uma das entradas salvas, mas sem cookie não dá acesso.
Para front-end de terceiros, use seu servidor e token de usuário. Não conte com acesso aleatório entre domínios de cookie: público CORS para qualquer site não.