API Reference
이메일 발신 도메인 검증
공급자에 지금 상태를 물어보고 결과를 저장한 뒤 갱신된 도메인을 돌려줍니다.
DNS 레코드를 심은 뒤 이 API 를 호출해 verified 가 되었는지 확인합니다.
멱등입니다. 몇 번을 호출해도 상태만 갱신됩니다. DNS 전파 대기 중에는 pending 이 그대로
유지되므로, 수 분 간격으로 다시 호출하세요.
⚠️ 공급자에 일시적으로 연결하지 못하면 503 이며, 저장된 상태는 바뀌지 않습니다 —
이미 verified 였던 도메인이 우리 쪽 장애로 실패 처리되는 일은 없습니다.
반대로 CNAME 이 사라진 것이 확인되면 failed 로 내려갑니다.
⚠️ 요청 본문은 없지만 Content-Length: 0 은 필요합니다. 본문도 이 헤더도 없는 POST 는
ClawOps 에 닿기 전에 게이트웨이가 411 Length Required 로 거절합니다(HTML 응답이라
{ error, code } 형식도 아닙니다). 대부분의 HTTP 클라이언트·SDK 는 이 헤더를 자동으로
붙이지만, curl -X POST 는 붙이지 않습니다 — curl -X POST -H 'Content-Length: 0' …
또는 curl -X POST -d '{}' … 로 호출하세요.
Authorization
BearerAuth AuthorizationBearer <token>
API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
accountId*string
계정 ID
emailDomainId*string
도메인 리소스 ID
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/email-domains/clx9edm00001/verification"{
"id": "clx9edm00001",
"domain": "mail.example.com",
"status": "pending",
"dnsRecords": [
{
"purpose": "dkim",
"requirement": "required",
"type": "CNAME",
"name": "abc123._domainkey.mail.example.com",
"value": "abc123.dkim.amazonses.com",
"priority": null
}
],
"receivingEnabled": false,
"receivingStatus": null,
"receivingCheckedAt": null,
"mailFromStatus": null,
"dmarcStatus": null,
"lastCheckedAt": "2026-09-02T00:00:00.000Z",
"verifiedAt": null,
"pendingExpiresAt": "2026-09-05T00:00:00.000Z",
"createdAt": "2026-09-02T00:00:00.000Z",
"updatedAt": "2026-09-02T00:00:00.000Z"
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}{
"error": "string",
"code": "recipient_blocked",
"ip": "52.79.213.41",
"blockers": [
{
"number": "07012340002",
"code": "number_not_carrier_issued",
"message": "이용증명원은 한국AI통신이 개통한 070·대표번호만 발급됩니다."
}
]
}