이메일 발신 도메인 목록 조회
GET /v1/email-sender-domains · 권한 email-sender-domains:read · 모든 요금제
환경의 이메일 발신 도메인을 오래된 순서대로 나열합니다. 환경당 발신 도메인은 최대 10개이므로 목록은 페이지로 나뉘지 않으며, list_metadata.before와 list_metadata.after는 항상 null입니다. 발신 도메인은 production 환경에만 존재하며, 다른 환경에서는 목록이 비어 있습니다.
요청 매개변수나 본문은 없습니다.
응답
200 OK와 함께 환경의 모든 발신 도메인을 반환합니다. 각 항목에는 이메일 발신 도메인 조회에서 설명하는 필드가 포함됩니다.
{
"data": [
{
"id": "sdom_01k7r9m3q5t8v2w4x6y8z0a2b4",
"domain": "mail.example.com",
"status": "pending_dns",
"active_selector": "akp1",
"dkim_status": null,
"return_path_status": null,
"dmarc_alignment": null,
"last_checked_at": null,
"failing_since": null,
"degraded_since": null,
"records": [
{
"type": "CNAME",
"name": "akp1._domainkey.mail.example.com",
"value": "akp1.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
"required": true
},
{
"type": "CNAME",
"name": "akp2._domainkey.mail.example.com",
"value": "akp2.sdom_01k7r9m3q5t8v2w4x6y8z0a2b4.dkim.eu.keenauth.app",
"required": true
},
{
"type": "CNAME",
"name": "rp.mail.example.com",
"value": "rp.eu.mail.keenauth.app",
"required": true
}
],
"version": 1,
"created_at": "2026-10-19T09:00:00Z",
"updated_at": "2026-10-19T09:00:00Z"
}
],
"list_metadata": {
"before": null,
"after": null
}
}
오류
| HTTP | code | 발생 조건 |
|---|---|---|
| 401 | unauthenticated |
자격 증명이 없거나, 잘못되었거나, 취소되었습니다. |
| 403 | insufficient_permissions |
자격 증명에 필요한 권한이 없습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After 기간 이후에 다시 시도하십시오. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. Retry-After 기간 이후에 다시 시도하십시오. |
예시
curl https://api.eu.keenauth.com/v1/email-sender-domains \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI: keenauth email-sender-domains list