메인 콘텐츠로 건너뛰기
POST
curl
POST /v3/ip/risk/는 백엔드가 이미 IP 주소를 보유하고 있으며 서버 간 위험 판정이 필요할 때 사용합니다. 응답에는 지리적 위치, 네트워크 소유자, VPN/Tor 및 데이터 센터 플래그, 위협 데이터가 포함됩니다. 제시한 국가를 보내면 country_mismatch도 포함됩니다.

응답 해석

  • status는 확인된 국가가 claimed_country와 충돌하거나, 해당 주소가 VPN, Tor 또는 데이터 센터 인프라와 연관된 경우 In Review입니다. 그 외에는 Approved입니다.
  • ip.ip_country_code에는 확인된 국가 코드가 담깁니다. 국가 문자열을 직접 비교하지 말고 ip.country_mismatch로 비교하십시오.
  • ip.latitude와 ip.longitude는 대략적인 네트워크 지리 위치이며, 정확한 기기 위치가 아닙니다.
  • ip.is_vpn_or_tor, ip.is_data_center, ip.proxy_type, ip.threat는 네트워크 위험 근거를 나타냅니다.
  • ip.asn_number, ip.asn_organization, ip.connection_type, ip.carrier는 해당 주소가 속한 네트워크를 설명합니다.
  • request_id는 API 세션 ID입니다. 결과를 나중의 webhook이나 콘솔 활동과 연관지어야 하면 vendor_data와 함께 저장하십시오.
IP 정보 보강은 최선의 노력 방식으로 제공됩니다. 어떤 보강 소스도 사용 가능한 데이터를 반환하지 않으면, endpoint는 ip.ip_address: null, ip.country_mismatch: null, 빈 ip.threat 객체를 포함한 승인 응답을 반환합니다. 개별 보강 필드도 사용할 수 없는 경우 null일 수 있습니다.

기기 인텔리전스

IP Risk API는 순수한 서버 간 endpoint입니다. 기기 핑거프린팅은 서버 간 방식만으로는 수행할 수 없습니다. 백엔드만으로는 브라우저나 기기 신호를 관찰할 수 없기 때문입니다. 호스팅 플로우와 SDK 세션의 경우, Didit은 세션 응답에 이미 수집된 기기 필드를 노출합니다. 여기에는 device_fingerprint, 기기 및 브라우저 세부 정보, user_agent, 원시 기기 데이터, 세션 간 일치 항목이 포함됩니다.

샌드박스 동작

샌드박스 키는 요청을 검증하고 항상 동일한 승인 데이터를 반환합니다. 외부 인텔리전스 서비스에 연결하지 않으며, 크레딧을 소비하지 않고, 세션을 생성하지 않으며, Networks에 기여하지 않습니다.

결제

IP Risk API 호출은 정가 기준 $0.02입니다. 프로덕션 환경 요청은 조회가 시작되는 순간부터 과금됩니다.

인증

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
ip_address
string<ip>
필수

점수를 산정할 IPv4 또는 IPv6 주소입니다.

예시:

"8.8.8.8"

claimed_country
string

사용자 또는 세션에서 주장한 선택적 ISO 3166-1 alpha-2 또는 alpha-3 국가입니다. country_mismatch를 계산하는 데 사용됩니다.

Maximum string length: 3
예시:

"ESP"

user_agent
string

백엔드에서 확인된 사용자 에이전트입니다. 요청 컨텍스트로 저장되며 기기 핑거프린팅 기능은 제공하지 않습니다.

Maximum string length: 512
vendor_data
string

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

metadata
object | null

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

응답

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

request_id
string<uuid>
필수

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

status
enum<string>
필수

이 API 세션에 대한 결정: 네트워크 또는 국가 불일치 위험이 있는 경우 In Review, 그렇지 않으면 Approved입니다.

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

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

vendor_data
string | null

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

metadata
object | null

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

ip
object

IP 위험 결과입니다. 조회를 통해 사용할 수 있는 데이터가 반환되지 않은 경우 개별 보강 필드는 null일 수 있습니다.

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