Kimlik yönetimi (gönderen adresleri)

Gönderen kimliği = mail göndermeye yetkili domain veya e-posta adresi. Akış: ekle → DNS kayıtlarını gir → verify → verified.

Uçlar (5)

GET/identitiesÖzet liste
POST/identitiesKimlik ekle
GET/identities/{id}/dns-recordsDNS kayıtları
POST/identities/{id}/verifyDurumu tazele
DELETE/identities/{id}Kimlik sil

Özet liste

GET/public/v1/identitiesscoperead

status: pending | verified | failed | temporary_failure. Tüm kimlikler durumlarıyla döner (hangi adres kullanılabilir, hangisi doğrulama bekliyor görülsün diye).
Domain kimliğinde address temsili noreply@<domain>'dir; from alanına o domain altındaki herhangi bir adres yazılabilir.

Hatalar

GET/identities

curl https://api.mailmaks.com/mail/api/public/v1/identities \
  -H "Authorization: Bearer mm_live_..."

Yanıt200

{
  "items": [
    {
      "address": "noreply@ornek.com",
      "status": "verified",
      "type": "domain",
      "isDefault": true
    }
  ]
}

Kimlik ekle

POST/public/v1/identitiesscopesend

Yanıt detay şeklidir (özet listeden farklı — panel sözleşmesiyle birebir). Aynı değer zaten kayıtlıysa → 409 identity_exists.

Gövde

Ad	Tip	Zorunlu	Açıklama
`type`	string	evet	`domain` \| `email`.
`value`	string	evet	Domain adı veya e-posta adresi.

Hatalar

POST/identities

curl -X POST https://api.mailmaks.com/mail/api/public/v1/identities \
  -H "Authorization: Bearer mm_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "domain",
    "value": "ornek.com"
  }'

Yanıt200

{
  "id": "idn_…",
  "type": "domain",
  "value": "ornek.com",
  "status": "pending",
  "dkimStatus": "pending",
  "mailFromStatus": "pending",
  "dmarcStatus": "none",
  "isDefault": false,
  "createdAt": "…"
}

DNS kayıtları

GET/public/v1/identities/{id}/dns-recordsscoperead

DKIM CNAME'leri, MAIL FROM MX/SPF ve DMARC kayıtlarını purpose etiketiyle döner; DNS sağlayıcınıza girin.

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Kimlik id'si (`idn_…`).

Hatalar

GET/identities/{id}/dns-records

curl https://api.mailmaks.com/mail/api/public/v1/identities/idn_…/dns-records \
  -H "Authorization: Bearer mm_live_..."

Yanıt200

{
  "records": [
    {
      "purpose": "dkim",
      "type": "CNAME",
      "name": "abc._domainkey.ornek.com",
      "value": "abc.dkim.amazonses.com",
      "status": "pending"
    },
    {
      "purpose": "mail_from_mx",
      "type": "MX",
      "name": "…",
      "value": "…",
      "status": "pending"
    },
    {
      "purpose": "mail_from_spf",
      "type": "TXT",
      "name": "…",
      "value": "…",
      "status": "pending"
    },
    {
      "purpose": "dmarc",
      "type": "TXT",
      "name": "_dmarc.ornek.com",
      "value": "v=DMARC1; …",
      "status": "pending"
    }
  ]
}

Durumu tazele

POST/public/v1/identities/{id}/verifyscopesend

Doğrulama durumunu sağlayıcıdan tazeler; güncel kimlik detayını döner. DNS yayılımı sürerken pending kalabilir — aralıklarla tekrar çağırın.

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Kimlik id'si (`idn_…`).

Hatalar

POST/identities/{id}/verify

curl -X POST https://api.mailmaks.com/mail/api/public/v1/identities/idn_…/verify \
  -H "Authorization: Bearer mm_live_..."

Yanıt200

{
  "id": "idn_…",
  "type": "domain",
  "value": "ornek.com",
  "status": "verified",
  "dkimStatus": "verified",
  "mailFromStatus": "verified",
  "dmarcStatus": "none",
  "isDefault": false,
  "createdAt": "…"
}

Kimlik sil

DELETE/public/v1/identities/{id}scopesend

Başarıda 204 (gövdesiz). Kampanyada kullanılan kimlik silinemez → 409 identity_in_use.

Path parametreleri

Ad	Tip	Zorunlu	Açıklama
`id`	string	evet	Kimlik id'si (`idn_…`).