Yetki ve erişim alanları
Bağlantıyla giriş
Sunucunuz X-API-Key ve X-Customer-ID ile POST /v1/auth/login-link çağrısı yapar. Yalnızca ilgili posta kutusunu açmak için mailbox_id belirtin; tüm hesabı açmak için bu alanı atlayın. locale arayüz dilini seçer.
Yanıt login_url, expires_in=300, expires_at (UTC), account_id ve mailbox_id içerir. “Postayı aç” düğmesi #token dahil login_url adresinin tamamını açar. Bağlantı 5 dakika geçerlidir ve yalnızca bir kez kullanılabilir. Bağlantıyı günlüğe kaydetmeyin ve API anahtarını tarayıcıda açığa çıkarmayın.
Giriş sayfası belirteci adres çubuğundan kaldırır ve HttpOnly çerezleriyle değiştirir. Hata veya süre aşımında yeni bağlantı oluşturun. Erişim kapsamı, hesap ve posta kutusu durumu tekrar kontrol edilir. Kullanıcı oturumları bağlantı oluşturamaz.
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}İş ortağı anahtarı
Entegrasyonunuzun posta API-anahtarını kullanın. Bunu posta hesabının X-API-Key ve ID adresine iletin - gerekli başlıkta X-Customer-ID. Bu, posta kutusunun external_id değil, ID değil, hesabın ID'sidir. Anahtar yalnızca entegrasyonunuzun istemcilerine erişim sağlar.
Anahtarı partnerinizin sunucusunda saklayın. Paylaşılan entegrasyon anahtarını tarayıcıya veya mobil uygulamaya yerleştirmeyin.
curl 'https://adapt-mail.com/v1/mailboxes' \ -H 'X-API-Key: <mail-api-key>' \ -H 'X-Customer-ID: <mail-account-id>'Kullanıcı jetonu
POST /v1/auth/token kabul eder login, password ve mode. mode=account için oturum açma adı user-ID kullanılır, mode=mailbox için tam posta kutusu adresi kullanılır. Hesap ve posta kutusu şifreleri bağımsızdır.
Yanıt access_token, token_type=Bearer ve expires_in=3600. içeriyor. Hesap jetonu kutularını açar; kutu belirteci - yalnızca bir kutu. Süre dolduktan sonra yeni bir jeton alacaksınız.
POST /v1/auth/tokenContent-Type: application/json
{"login":"user-123","password":"<password>","mode":"account"}
GET /v1/mailboxesAuthorization: Bearer <access_token>Tarayıcı oturumları
POST /v1/auth/login kendi sitesi içindir adapt-mail.com. Doğru Origin gerektirir ve HttpOnly cookies. Sınıflandırılmamış X-Mail-Session dosyasını yükler, kaydedilen girişlerden birini seçer, ancak cookie olmadan erişim vermez.
Üçüncü taraf ön uç için sunucunuzu ve kullanıcı belirtecinizi kullanın. Herhangi bir site için cookie: genel CORS tarafından etki alanları arası rastgele erişime güvenmeyin.