시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역curl
curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.networks.retrieve(
"n3a5e000-0000-4000-8000-000000000001",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"network_id": "N-0042",
"name": null,
"status": "in_review",
"risk": {
"score": 82,
"band": "high",
"bar": 0.82
},
"pattern_types": [
"exact_same_device",
"same_email"
],
"signal_types": [
"device",
"email"
],
"member_counts": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signal_coverage": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
},
"first_activity_at": "2026-10-01T09:12:44Z",
"last_activity_at": "2026-10-12T16:03:10Z",
"stats": {
"members": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signals": {
"total": 2,
"by_type": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
}
}
},
"fraud_tags": [],
"risk_signals": {
"residential_proxy_reuse": {
"detected": false,
"signal_count": 0,
"max_subject_count": 0
},
"email_intelligence": {
"enriched_signal_count": 1,
"high_risk_count": 0,
"social_profile_count": 0
},
"phone_intelligence": {
"enriched_signal_count": 0,
"high_risk_count": 0
}
},
"reviewed_at": "2026-10-12T16:30:00Z",
"reviewed_by": "reviewer@example.com",
"review_reason": "Shared device across three new accounts.",
"notes_count": 0,
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"tags": [
{
"uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "SUSPICIOUS",
"color": "#6366F1",
"source": "custom",
"added_by": null,
"added_at": "2026-10-13T08:15:00Z"
}
],
"outcomes": {
"approved": 1,
"declined": 1,
"in_review": 0,
"total": 3
},
"patterns": [
{
"type": "background",
"score": 0.8125,
"members": 3,
"reason": null,
"computed_at": "2026-10-13T08:00:00Z"
}
]
}네트워크
사기 네트워크 조회 API
단일 사기 네트워크의 전체 정보를 조회합니다. 통계, 사기 태그, 위험 신호, 귀사의 태그, 멤버 결과, 셀피 배경 패턴 점수, 조직 간 접근 권한을 포함합니다. Didit Management API 제공.
GET
/
v3
/
organization
/
{organization_id}
/
application
/
{application_id}
/
networks
/
{network_uuid}
/
curl
curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/n3a5e000-0000-4000-8000-000000000001/' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
result = client.networks.retrieve(
"n3a5e000-0000-4000-8000-000000000001",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
const result = await didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001");
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
result, err := client.Networks.Retrieve(ctx, "n3a5e000-0000-4000-8000-000000000001")
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
var result = client.networks().retrieve("n3a5e000-0000-4000-8000-000000000001");
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
$result = $didit->networks->retrieve('n3a5e000-0000-4000-8000-000000000001');
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
result = didit.networks.retrieve("n3a5e000-0000-4000-8000-000000000001")
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
var result = await client.Networks.RetrieveAsync("n3a5e000-0000-4000-8000-000000000001");
Console.WriteLine(JsonSerializer.Serialize(result));{
"uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"network_id": "N-0042",
"name": null,
"status": "in_review",
"risk": {
"score": 82,
"band": "high",
"bar": 0.82
},
"pattern_types": [
"exact_same_device",
"same_email"
],
"signal_types": [
"device",
"email"
],
"member_counts": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signal_coverage": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
},
"first_activity_at": "2026-10-01T09:12:44Z",
"last_activity_at": "2026-10-12T16:03:10Z",
"stats": {
"members": {
"total": 3,
"users": 3,
"businesses": 0,
"transaction_parties": 0
},
"member_status": {
"approved": 1,
"declined": 1,
"in_review": 0,
"not_completed": 1
},
"signals": {
"total": 2,
"by_type": {
"device": {
"signals": 1,
"subjects": 3,
"coverage": 1
},
"email": {
"signals": 1,
"subjects": 2,
"coverage": 0.6667
}
}
}
},
"fraud_tags": [],
"risk_signals": {
"residential_proxy_reuse": {
"detected": false,
"signal_count": 0,
"max_subject_count": 0
},
"email_intelligence": {
"enriched_signal_count": 1,
"high_risk_count": 0,
"social_profile_count": 0
},
"phone_intelligence": {
"enriched_signal_count": 0,
"high_risk_count": 0
}
},
"reviewed_at": "2026-10-12T16:30:00Z",
"reviewed_by": "reviewer@example.com",
"review_reason": "Shared device across three new accounts.",
"notes_count": 0,
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"tags": [
{
"uuid": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"name": "SUSPICIOUS",
"color": "#6366F1",
"source": "custom",
"added_by": null,
"added_at": "2026-10-13T08:15:00Z"
}
],
"outcomes": {
"approved": 1,
"declined": 1,
"in_review": 0,
"total": 3
},
"patterns": [
{
"type": "background",
"score": 0.8125,
"members": 3,
"reason": null,
"computed_at": "2026-10-13T08:00:00Z"
}
]
}
네트워크 하나를 조회합니다. 네트워크 개요 패널을 렌더링하는 데 필요한 정보를 모두 반환합니다. 목록과 공유 필드 외에 위험 분석, 감지된 사기 태그, 위험 신호 요약이 포함됩니다.
상세 정보에는 귀사의 애플리케이션이 네트워크에 붙인 태그, 구성원의 인증 상태도 포함되며, 구성원의 셀피 배경이 얼마나 유사한지도 나타냅니다.
거부된 후 재시도에서 나중에 승인된 멤버는
읽을 수 없거나 배경이 너무 적게 보이는 셀피는 비교되지 않습니다. 따라서
태그
tags는 네트워크에 붙은 귀사 애플리케이션의 태그를 오래된 순서대로 나열합니다.
각 애플리케이션은 자신의 태그만 보고 변경할 수 있습니다.
added_by는 태그를 추가한 콘솔 멤버의 이메일입니다. API 키가 태그를 추가한 경우에는 null입니다.
태그를 변경하려면 네트워크 태그 추가와 네트워크 태그 삭제를 사용하십시오.
fraud_tags는 변경되지 않습니다. 네트워크 구성원이 가진 태그를 나열합니다.
구성원 결과
outcomes는 귀사가 볼 수 있는 네트워크 내 개인과 기업을 집계하며, 각 항목은 한 번만 계산됩니다.
| 키 | 집계 대상 |
|---|---|
approved | 가장 최근에 결정된 인증이 승인된 멤버 |
declined | 가장 최근에 결정된 인증이 거부된 멤버 |
in_review | 가장 최근에 결정된 인증이 검토 중인 멤버 |
total | 결정 여부와 관계없이 인증이 하나 이상 있는 멤버 |
approved로 계산됩니다.
모든 인증이 아직 결정되지 않은 멤버(시작되지 않음, 진행 중, 만료됨 또는 중단됨)는 total에만 포함됩니다.
거래 당사자는 인증을 거치지 않으므로 집계되지 않습니다.
셀피 배경 패턴
patterns에는 현재 항목이 하나 있으며, type은 background입니다.
score는 0에서 1 사이 값으로, 인물을 제외한 모든 멤버 셀피 배경 쌍의 평균 유사도입니다.
점수가 1에 가까우면 셀피가 같은 장소에서 촬영되었을 가능성이 높음을 나타냅니다.
비슷한 색의 단순한 벽도 높은 점수를 받을 수 있으므로, 점수는 검토를 위한 근거로만 사용하고 증거로 단정하지 마십시오.
점수는 각 인물의 최신 셀피를 읽되, 가장 최근 셀피 최대 50개로 제한하며, 연령 확인 세션은 제외합니다.
애플리케이션 멤버만이 아니라 네트워크 전체를 대상으로 합니다.
reason | score | members | 조치 |
|---|---|---|---|
null | 0~1 | 비교된 셀피 | 점수를 사용하십시오. computed_at은 계산된 시점입니다. |
computing | null | null | 현재 멤버의 점수를 계산하는 중입니다. 나중에 네트워크를 다시 조회하십시오. |
not_enough_selfies | null | 0 또는 1 | 사용 가능한 셀피를 가진 멤버가 두 명 미만입니다. |
members는 네트워크 내 인물 수보다 적을 수 있습니다.
점수는 항상 현재 멤버의 셀피를 기준으로 합니다.
멤버가 가입하거나 탈퇴하는 등 셀피가 바뀌면, 새 점수가 준비될 때까지 상세 정보는 computing을 반환하고, 남은 셀피가 두 개 미만이면 not_enough_selfies를 반환합니다.
조직 간 가용성
상세 정보에는 네트워크 목록 조회와 같은sharing_mode, cross_org_available, cross_org_unavailable_reason이 포함됩니다.
조직 간 신호는 Enterprise 요금제와 global 공유 모드가 모두 필요합니다.
관련 항목
인증
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 를 참고하십시오.
경로 매개변수
조직 UUID입니다.
애플리케이션 UUID입니다.
네트워크 UUID입니다.
예시:
"n3a5e000-0000-4000-8000-000000000001"
응답
네트워크 세부 정보입니다.
네트워크 세부 정보와 조직의 공유 모드, 교차 조직 신호 적용 여부, 네트워크에서의 애플리케이션 태그, 멤버 결과 및 패턴 점수입니다.
사람이 읽을 수 있는 조직별 순차 ID(예: N-0001)입니다.
네트워크 라이프사이클 상태입니다. 네트워크 내부의 신청자별 outcome_status(approved/in_review/declined/not_completed)와 구별됩니다.
사용 가능한 옵션:
active, in_review, resolved, dismissed Show child attributes
Show child attributes
이 네트워크에서 감지된 클러스터링 패턴입니다.
사용 가능한 옵션:
exact_same_device, similar_device, same_ip_address, same_address, similar_selfie_backgrounds, similar_poa_documents, same_document_number, same_phone_number, same_email 이 네트워크에 존재하는 고유한 신호 유형들입니다.
사용 가능한 옵션:
ip_address, device, face, document_number, phone, email, address 카테고리별 멤버 수(예: 전체, outcome_status별).
outcome_status별 멤버 내역입니다.
이 네트워크 멤버들의 signal_type별 적용 범위입니다.
네트워크에 대한 집계 통계입니다(예: 멤버 총수).
네트워크에 나타난 사기 패턴 태그입니다.
위험 신호 요약: residential_proxy_reuse, email_intelligence, phone_intelligence.
이 조사에 포함된 비공개 분석가 메모 수입니다.
필수 범위:
x >= 0조직의 조직 간 공유 모드입니다. global만 조직 간 네트워크를 비교하며, private 및 off는 해당 조직 자체의 이력으로만 제한합니다.
사용 가능한 옵션:
off, private, global 예시:
"global"
조직 간 신호가 이 조직에 적용되는지 여부입니다. 엔터프라이즈 플랜과 global 공유 모드가 모두 필요합니다.
예시:
true
조직 간 신호가 적용되지 않는 이유(확인 순서 기준). plan: 공유 모드와 관계없이 조직의 요금제에 조직 간 사기 방지 네트워크가 포함되어 있지 않습니다(Enterprise 요금제 필요). sharing_mode: 요금제에는 포함되어 있으나 공유 모드가 private 또는 off입니다. cross_org_available이 true인 경우 null입니다.
사용 가능한 옵션:
plan, sharing_mode 예시:
null
네트워크상에서 귀하 애플리케이션의 태그로, 오래된 순으로 정렬됩니다. 각 애플리케이션은 자신의 태그만 볼 수 있습니다. fraud_tags는 별개이며 변경되지 않습니다. 이는 네트워크 멤버들이 보유한 태그입니다.
Show child attributes
Show child attributes
네트워크의 개인 및 기업의 현재 상태입니다. 조회 가능한 각 멤버는 결정에 도달한 가장 최근 인증 상태에 따라 한 번씩 카운트됩니다. 거래 당사자는 카운트되지 않습니다.
Show child attributes
Show child attributes
전체 네트워크에 걸친 패턴 점수입니다. 현재는 background 항목 하나만 제공됩니다.
Show child attributes
Show child attributes
마지막 수정일 2026년 11월 7일