승인 및 접근 영역

API 0.16.0OpenAPIllms-full.txt

링크로 로그인

서버에서 X-API-Key와 X-Customer-ID로 POST /v1/auth/login-link를 호출합니다. mailbox_id를 지정하면 해당 사서함만 열리고, 생략하면 전체 계정이 열립니다. locale은 인터페이스 언어를 선택합니다.

응답에는 login_url, expires_in=300, expires_at(UTC), account_id, mailbox_id가 포함됩니다. “메일 열기” 버튼은 #token을 포함한 전체 login_url을 엽니다. 링크는 5분 동안 한 번만 사용할 수 있습니다. 링크를 로그에 저장하거나 브라우저에 API 키를 노출하지 마세요.

로그인 페이지는 주소 표시줄에서 토큰을 제거하고 HttpOnly 쿠키로 교환합니다. 오류가 발생하거나 만료되면 새 링크를 만드세요. 접근 범위와 계정 및 사서함 상태를 다시 확인합니다. 사용자 세션으로는 링크를 생성할 수 없습니다.

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
}

파트너 키

통합의 메일 API-키를 사용하세요. 메일 계정의 X-API-Key 및 ID에 전달하세요 - 필수 헤더 X-Customer-ID.에 이것은 메일함의 external_id 및 ID이 아닌 계정의 ID입니다. 키를 사용하면 통합 클라이언트에만 액세스할 수 있습니다.

파트너의 서버에 키를 저장하세요. 브라우저나 모바일 애플리케이션에 공유 통합 키를 배치하지 마십시오.

curl 'https://adapt-mail.com/v1/mailboxes' \
  -H 'X-API-Key: <mail-api-key>' \
  -H 'X-Customer-ID: <mail-account-id>'

사용자 토큰

POST /v1/auth/token은 login, password 및 mode.을 허용합니다. mode=account의 경우 로그인 user-ID이 사용되고, mode=mailbox의 경우 전체 사서함 주소가 사용됩니다. 계정 및 사서함 비밀번호는 독립적입니다.

응답에는 access_token, token_type=Bearer 및 expires_in=3600.이 포함됩니다. 계정 토큰은 상자를 엽니다. 상자 토큰 - 상자가 하나만 있습니다. 만료 후에는 새 토큰을 받게 됩니다.

POST /v1/auth/token
Content-Type: application/json

{"login":"user-123","password":"<password>","mode":"account"}

GET /v1/mailboxes
Authorization: Bearer <access_token>

브라우저 세션

POST /v1/auth/login은 자체 사이트 adapt-mail.com.용입니다. 올바른 Origin이 필요하고 HttpOnly을 설치합니다. cookies. 분류되지 않음 X-Mail-Session은 저장된 입력 중 하나를 선택하지만 cookie이 없으면 액세스 권한을 부여하지 않습니다.

타사 프런트엔드의 경우 서버와 사용자 토큰을 사용하세요. 모든 사이트 번호에 대해 cookie: 공개 CORS에서 임의의 교차 도메인 액세스를 기대하지 마십시오.