메인 콘텐츠로 건너뛰기
POST
curl
Email Risk API 요청은 POST /v3/email/risk/를 사용하세요. 사용자에게 일회용 코드를 입력하도록 요구하지 않고도 이메일 인텔리전스를 얻을 수 있습니다. 이 API는 이메일을 보내지 않습니다. API 세션을 생성하고, 주소를 보강하며, 귀사의 이메일 위험 규칙을 적용합니다. 그리고 하나의 동기식 응답으로 이메일 인증에서 사용하는 것과 같은 정규화된 이메일 블록을 반환합니다. 요청이 저장되면 Didit은 점수가 매겨진 이메일을 Networks에서 집계 증거로도 사용할 수 있습니다. 네트워크 그래프에는 공유된 이메일 신호에 대한 고위험 이메일 인텔리전스, 유출 정보 맥락, 소셜 프로필 커버리지가 표시될 수 있습니다. 다만 다른 조직에 원본 이메일 주소를 노출하지는 않습니다.

응답 해석

  • status는 이 API 세션의 최종 결정입니다. 보통 Approved이며, 위험 평가에서는 In Review 또는 Declined가 나올 수 있습니다.
  • email.is_breached, email.is_disposable, email.is_undeliverable은 애플리케이션 로직에서 사용할 수 있는 안정적인 예/아니요 신호입니다.
  • email.breaches는 적용 범위가 있을 때 해당 주소가 포함된 가장 최근의 알려진 유출 내역을 유출 날짜와 노출된 데이터 유형과 함께 나열합니다.
  • email.email_intelligence.score는 0~100 위험 척도를 사용하며, 숫자가 높을수록 위험이 큽니다. breach_risk_level(Low, Medium, High)과 no_of_breaches는 파생된 값입니다.
  • email.email_intelligence.reason_codes는 어떤 정규화된 신호가 결과에 기여했는지 설명합니다. 값은 시간이 지나면서 늘어날 수 있으므로 알 수 없는 코드를 거부하지 마세요.
  • email.email_intelligence와 email.enrichment는 같은 정규화된 객체를 가리키는 호환성 별칭입니다. 새로운 연동에서는 email.enrichment를 읽으면 됩니다.
  • email.matches는 같은 주소가 다른 사용자에 의해 사용된 애플리케이션의 다른 세션을 나열합니다. 중복 계정 탐지에 사용하세요.
  • request_id는 API 세션 ID입니다. 나중의 webhook이나 콘솔 활동과 결과를 연관시켜야 한다면 vendor_data와 함께 저장하세요.
email.email_intelligence와 email.enrichment는 최선의 노력으로 제공되는 필드입니다. 해당 주소, 도메인 또는 요금제에 대해 사용 가능한 인텔리전스 데이터가 반환되지 않으면, 조회가 완료되더라도 두 필드가 모두 생략될 수 있습니다. 규칙은 먼저 is_breached, is_disposable, is_undeliverable을 기준으로 작성하고, 인텔리전스 데이터가 없는 경우를 “안전함”이 아니라 “알 수 없음”으로 처리하세요.

소셜 발자국 부가 기능

enable_social을 true로 설정하면 응답의 email 아래에 email_social 블록이 추가됩니다. 이 블록에는 이메일 주소가 등록된 온라인 플랫폼이 카테고리별로 묶여 있고, 요약 개수와 데이터 파트너가 반환하는 프로필 세부 정보가 함께 포함됩니다.
  • email.email_social.profiles_registered와 email.email_social.profiles_checked는 핵심 수치입니다. 평가된 플랫폼 중 이메일 주소가 등록된 것으로 확인된 플랫폼의 수를 나타냅니다.
  • email.email_social.registered_platforms와 email.email_social.not_registered_platforms는 각 플랫폼을 category와 scope(global, 또는 지역별 플랫폼의 경우 local)와 함께 나열합니다.
  • email.email_social.categories는 카테고리별 등록 개수와 비율을 제공합니다. email.email_social.profiles는 플랫폼이 정보를 공개하는 경우 플랫폼별 프로필 세부 정보(이름, 사진 URL, 소개 텍스트, 개인정보 보호 상태, 비즈니스 계정 여부)를 포함합니다.
  • 요약 지표(digital_footprint_diversity, digital_sophistication_index, engagement_depth_index, subscription_affordability_index)는 0~10 복합 점수입니다. 확인 과정에서 데이터가 반환되지 않은 개수는 모두 null일 수 있습니다.
profiles_registered: 0은 실패가 아니라 실제 결과입니다. 플랫폼을 확인했고 이메일 주소가 어디에도 없었다는 뜻이며, 이는 흔한 합성 신원 신호입니다. 이 엔드포인트는 이 값만으로 조치를 취하지 않습니다. 이를 검토 또는 거부 판정으로 바꾸려면 워크플로에서 email_no_social_presence_action을 사용하세요. enable_social을 설정하지 않으면 블록이 없습니다. 소셜 확인을 완료하지 못한 경우에도 블록이 없으며, 이때는 과금되지 않습니다.

샌드박스 동작

샌드박스 키는 요청을 검증하고 항상 동일한 승인 데이터를 반환합니다. 이메일을 보내지 않고, 크레딧을 소모하지 않으며, 세션을 생성하지 않고, Networks에 기여하지도 않습니다. enable_social을 설정하면 항상 동일한 email_social 블록도 함께 반환합니다.

결제

Email Risk API 호출은 정가 기준 $0.04입니다. 이메일을 보내지 않기 때문에 전체 이메일 인증보다 비용이 낮습니다. 실제 요청은 조회가 시작되는 시점부터 과금되며, 최선 노력 필드 일부를 사용할 수 없더라도 마찬가지입니다. 소셜 발자국 부가 기능은 별도로 과금됩니다. 요청당 Email Risk API 가격에 더해 email_social 단위 1개가 부과되며, 확인이 완료될 때마다 적용됩니다. 조회 전에 수행되는 크레딧 확인은 두 항목을 모두 포함합니다.

인증

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>
필수

점수를 산정할 이메일 주소입니다.

예시:

"alice@example.com"

country_code
string

인텔리전스 적용 범위를 위한 선택적 ISO 3166-1 alpha-2 또는 alpha-3 국가 힌트입니다.

Maximum string length: 3
예시:

"US"

signals
object

애플리케이션에서 관찰한 선택적 기기 및 네트워크 컨텍스트입니다. 모든 필드는 선택 사항입니다. 이를 전달하면 Networks의 세션 간 일치 감지 기능에 데이터가 제공됩니다.

vendor_data
string

이 요청에 대한 안정적인 참조값입니다. API 세션에 저장되며 응답에 그대로 반영됩니다.

metadata
object | null

귀하의 비민감 JSON 메타데이터입니다. API 세션에 저장되며 응답에 그대로 반환됩니다.

enable_social
boolean
기본값:false

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

예시:

true

응답

위험 평가가 완료되었습니다. 결정 사항은 status를 확인하십시오. 완료된 조회의 경우 HTTP는 항상 200입니다.

request_id
string<uuid>
필수

이 요청에 대해 생성된 API 세션의 ID입니다. 결과를 향후의 webhook이나 콘솔 활동과 연결해야 하는 경우 vendor_data와 함께 저장하세요.

status
enum<string>
필수

이 API 세션의 최종 결정입니다. 일반적으로 Approved이며, 위험 평가에 따라 In Review 또는 Declined가 생성될 수 있습니다.

사용 가능한 옵션:
Approved,
In Review,
Declined
created_at
string<date-time>
필수

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

vendor_data
string | null

전송한 vendor_data의 에코 값이며, 전송하지 않은 경우 null입니다.

metadata
object | null

전송한 metadata의 에코 값이며, 전송하지 않은 경우 null입니다.

email
object

이메일 인증 응답에서 사용되는 것과 동일한 블록인 정규화된 이메일 보고서입니다.

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