메인 콘텐츠로 건너뛰기
POST
curl

인텔리전스 추가 기능

enable_enrichment를 true로 설정하면 해당 주소에 대해 이메일 인텔리전스도 실행되어 위험 점수와 유출 이력을 함께 받을 수 있습니다. 이 추가 기능은 정가 기준으로 요청당 $0.05가 부과되며, 검사 요금에 더해 청구됩니다. 잔액이 이 금액을 감당할 수 없으면 요청은 403을 반환합니다. 세 개의 필드가 신호의 동작을 결정합니다. 각 필드의 값은 NO_ACTION(기본값) 또는 DECLINE이며, 각 필드는 enable_enrichment가 true일 때만 적용됩니다. NO_ACTION으로 설정하면 해당 신호는 여전히 email.email_intelligence에 반환되므로, 직접 정한 규칙을 적용할 수 있습니다.

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

본문

application/json
email
string<email>
필수

일치하는 POST /v3/email/send/ 호출에 사용된 것과 동일한 이메일 주소입니다. 이를 통해 검증과 전송이 연결됩니다.

예시:

"alice@example.com"

code
string
필수

최종 사용자가 수신한 OTP: 48자리 숫자이거나, 발송 시 alphanumeric_code: true를 사용한 경우 48자리 문자/숫자입니다. 비교 시 대소문자를 구분하지 않습니다.

Maximum string length: 10
예시:

"123456"

duplicated_email_action
enum<string>
기본값:NO_ACTION

동일한 주소가 애플리케이션의 다른 사용자(다른 vendor_data)에 의해 이미 사용되고 승인되었을 때 수행할 작업입니다(이전에 승인된 인증만 계산됨). DECLINE은 최종 status를 Declined로 변경하며, NO_ACTION은 위험을 email.warnings에 기록하고 email.matches를 채웁니다.

사용 가능한 옵션:
NO_ACTION,
DECLINE
breached_email_action
enum<string>
기본값:NO_ACTION

알려진 데이터 유출 사고에 해당 주소가 포함되어 있을 때(email.is_breached) 수행할 작업입니다. DECLINE은 최종 status를 Declined로 변경하고, NO_ACTION은 해당 위험을 email.warnings에 기록합니다.

사용 가능한 옵션:
NO_ACTION,
DECLINE
disposable_email_action
enum<string>
기본값:NO_ACTION

도메인이 일회용/임시 이메일 제공업체에 속할 때 수행할 작업입니다 (email.is_disposable). DECLINE은 최종 status를 Declined로 변경하며, NO_ACTION은 위험을 email.warnings에 기록합니다.

사용 가능한 옵션:
NO_ACTION,
DECLINE
enable_enrichment
boolean
기본값:false

true인 경우 해당 주소에 대한 이메일 인텔리전스(위험 점수 및 유출 이력)도 실행합니다. 이 endpoint의 자체 가격 외에 요청당 하나의 email_intelligence_api 단위(정가 기준 $0.05)로 청구됩니다. 잔액이 이를 충당하지 못하면 요청은 403을 반환합니다.

예시:

false

email_intelligence_score_action
enum<string>
기본값:NO_ACTION

이메일 인텔리전스 위험 점수가 임계값을 초과할 때 수행할 작업입니다. DECLINE은 최종 status를 Declined로 변경하며, NO_ACTION은 거부하지 않고 신호를 기록합니다. enable_enrichment가 true일 때만 적용됩니다.

사용 가능한 옵션:
NO_ACTION,
DECLINE
recent_email_breach_action
enum<string>
기본값:NO_ACTION

주소가 최근 알려진 데이터 침해에 포함된 경우의 작업입니다. DECLINE은 최종 status를 Declined로 변경합니다. NO_ACTION은 거부하지 않고 신호를 기록합니다. enable_enrichment가 true일 때만 적용됩니다.

사용 가능한 옵션:
NO_ACTION,
DECLINE
frequent_email_breach_action
enum<string>
기본값:NO_ACTION

주소가 알려진 다수의 데이터 침해에 포함된 경우의 작업입니다. DECLINE은 최종 status를 Declined로 변경합니다. NO_ACTION은 거부하지 않고 신호를 기록합니다. enable_enrichment가 true일 때만 적용됩니다.

사용 가능한 옵션:
NO_ACTION,
DECLINE
enable_social
boolean
기본값:false

true인 경우, 주소의 소셜 발자국(등록된 이메일, 소셜, 전문, 전자상거래 및 엔터테인먼트 플랫폼)도 조회합니다. 이 endpoint 자체의 가격 외에 요청당 email_social 1단위로 청구됩니다.

예시:

true

email_no_social_presence_action
enum<string>
기본값:NO_ACTION

소셜 풋프린트 검사 결과 지원하는 플랫폼 중 어느 곳에도 해당 주소가 등록되어 있지 않을 때 수행할 작업입니다. 이 endpoint에서는 NO_ACTION 및 DECLINE만 허용되며, 동일한 이름의 워크플로 구성 키에서는 REVIEW를 사용할 수 있습니다.

사용 가능한 옵션:
NO_ACTION,
DECLINE

응답

확인 완료 — 잘못된 코드 및 누락된 인증도 200을 반환하므로 HTTP 코드가 아닌 status를 확인하십시오. email은 최종 결과(Approved/Declined)에서만 채워지며, Failed에서는 null, Expired or Not Found에서는 제외됩니다.

request_id
string<uuid>

Approved/Declined인 경우: 일치하는 인증의 세션 ID — POST /v3/email/send/에서 반환된 request_id와 동일합니다. Failed 및 Expired or Not Found인 경우: 나중에 조회할 수 없는 일회성 무작위 UUID입니다.

status
enum<string>

Approved — 올바른 코드이며 거부 위험이 없음. Declined — 최종 상태: 거부 위험이 일치했거나 시도 횟수 한도(3회)가 소진됨. Failed — 잘못된 코드이며 잔여 시도 횟수가 있음. Expired or Not Found — 지난 5분 동안 이 주소에 대한 보류 중인 인증이 없음.

사용 가능한 옵션:
Approved,
Declined,
Failed,
Expired or Not Found
message
string

잘못된 코드 입력 후 남은 시도 횟수를 포함한 결과에 대한 사람이 읽기 쉬운 설명입니다.

email
object | null

전체 이메일 보고서입니다. 최종 완료된 결과(Approved/Declined)에만 존재(null이 아님)하며, Failed의 경우 null이고 Expired or Not Found의 경우 생략됩니다.

vendor_data
string | null

일치하는 인증 세션의 vendor_data입니다. Expired or Not Found인 경우 null입니다.

metadata
object | null

일치하는 인증 세션의 metadata입니다. Expired or Not Found인 경우 null입니다.

created_at
string<date-time>

이 검사 응답의 타임스탬프입니다.

마지막 수정일 2026년 11월 7일