이메일 도메인 수신 MX 확인
이 도메인의 MX 레코드를 실제로 조회해서 수신이 우리에게 오도록 걸렸는지 판정하고,
결과를 receivingStatus 에 저장한 뒤 갱신된 도메인을 돌려줍니다. MX 를 심은 뒤 호출하세요.
수신이 꺼져 있으면 422 입니다 — 먼저 수신을 켜세요.
판정 기준은 "우리 MX 가 있다" 가 아니라 "우리 MX 가 단독으로 가장 낮다" 입니다.
10 aspmx.l.google.com 20 inbound-smtp... → not_lowest_priority (전부 Google 로 갑니다)
10 aspmx.l.google.com 10 inbound-smtp... → not_lowest_priority (절반씩 나뉩니다)
10 inbound-smtp... → verified
⚠️ DNS 조회 자체에 실패하면(SERVFAIL·타임아웃) 200 이지만 아무것도 바뀌지 않습니다.
receivingCheckedAt 이 그대로면 확인하지 못한 것이니 잠시 뒤 다시 호출하세요. 조회 실패가
verified 를 뒤집거나 수신을 끄는 일은 없습니다. 반대로 MX 가 없다는 것이 확인되면
not_found 로 내려갑니다.
⚠️ DNS 전파에는 시간이 걸립니다(보통 수 분, TTL 에 따라 더 길 수 있음). 곧바로 not_found
가 나와도 정상이며, 수 분 간격으로 다시 호출하세요.
⚠️ 요청 본문은 없지만 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 API Key를 Bearer 토큰으로 전달
In: header
Path Parameters
계정 ID
도메인 리소스 ID
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/accounts/AC1a2b3c4d/email-domains/clx9edm00001/receiving-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·대표번호만 발급됩니다."
}
]
}