시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
for item in client.networks.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
for await (const item of didit.networks.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
for (var item : client.networks().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
foreach ($didit->networks->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
didit.networks.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
await foreach (var item in await client.Networks.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 123,
"next": 123,
"previous": 123,
"results": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"network_id": "<string>",
"name": "<string>",
"status": "active",
"risk": {
"score": 123,
"band": "low",
"bar": 123
},
"pattern_types": [
"exact_same_device"
],
"signal_types": [
"ip_address"
],
"member_counts": {},
"member_status": {},
"signal_coverage": {},
"first_activity_at": "2023-11-07T05:31:56Z",
"last_activity_at": "2023-11-07T05:31:56Z"
}
],
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"kpis": {
"active": {},
"in_review": {},
"applicants_involved": {},
"detected_this_period": {},
"false_positive_rate": {}
},
"counts": {
"scopes": {
"all": 123,
"identity": 123,
"transactions": 123
},
"views": {
"all": 123,
"active": 123,
"in_review": 123,
"resolved": 123,
"dismissed": 123,
"mine": 123,
"high_risk": 123
},
"facets": {
"total": 123,
"last_activity_days": {
"7": 123,
"30": 123,
"90": 123
},
"risk_min": {
"50": 123,
"80": 123
},
"signal_types": {
"ip_address": 123,
"device": 123,
"face": 123,
"document_number": 123,
"phone": 123,
"email": 123,
"address": 123
},
"priority": {
"low": 123,
"medium": 123,
"high": 123,
"none": 123
},
"assignee": {
"me": 123,
"unassigned": 123,
"users": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "<string>",
"count": 123
}
]
},
"has_case": 123,
"min_size": {
"10": 123
}
}
}
}사기 네트워크 목록 조회 API
Didit에서 조직 내 탐지된 사기 네트워크를 상태, 신호, 패턴, 위험 수준, 규모, 날짜로 필터링해 조회하고 공유 모드와 목록 수를 확인합니다.
curl -X GET 'https://verification.didit.me/v3/organization/11111111-2222-3333-4444-555555555555/application/aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee/networks/?status=active,in_review&ordering=-risk_score' \
-H 'x-api-key: YOUR_API_KEY'from didit import Didit
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
client = Didit()
for item in client.networks.list():
print(item)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
const didit = new Didit();
for await (const item of didit.networks.list()) {
console.log(item);
}ctx := context.Background()
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
client := didit.NewClient()
iter := client.Networks.ListAutoPaging(ctx, didit.NetworksListParams{})
for iter.Next() {
fmt.Printf("%+v\n", iter.Current())
}
if err := iter.Err(); err != nil {
log.Fatal(err)
}import me.didit.Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
Didit client = new Didit();
for (var item : client.networks().list()) {
System.out.println(item);
}<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
$didit = new DiditClient();
foreach ($didit->networks->list() as $item) {
print_r($item->toArray());
}require "didit"
# Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
# and DIDIT_APPLICATION_ID.
didit = Didit::Client.new
didit.networks.list.auto_paging_each do |item|
puts item.to_h
endusing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY, DIDIT_ORGANIZATION_ID
// and DIDIT_APPLICATION_ID.
using var client = new DiditClient();
await foreach (var item in await client.Networks.ListAsync())
{
Console.WriteLine(JsonSerializer.Serialize(item));
}{
"count": 123,
"next": 123,
"previous": 123,
"results": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"network_id": "<string>",
"name": "<string>",
"status": "active",
"risk": {
"score": 123,
"band": "low",
"bar": 123
},
"pattern_types": [
"exact_same_device"
],
"signal_types": [
"ip_address"
],
"member_counts": {},
"member_status": {},
"signal_coverage": {},
"first_activity_at": "2023-11-07T05:31:56Z",
"last_activity_at": "2023-11-07T05:31:56Z"
}
],
"sharing_mode": "global",
"cross_org_available": true,
"cross_org_unavailable_reason": null,
"kpis": {
"active": {},
"in_review": {},
"applicants_involved": {},
"detected_this_period": {},
"false_positive_rate": {}
},
"counts": {
"scopes": {
"all": 123,
"identity": 123,
"transactions": 123
},
"views": {
"all": 123,
"active": 123,
"in_review": 123,
"resolved": 123,
"dismissed": 123,
"mine": 123,
"high_risk": 123
},
"facets": {
"total": 123,
"last_activity_days": {
"7": 123,
"30": 123,
"90": 123
},
"risk_min": {
"50": 123,
"80": 123
},
"signal_types": {
"ip_address": 123,
"device": 123,
"face": 123,
"document_number": 123,
"phone": 123,
"email": 123,
"address": 123
},
"priority": {
"low": 123,
"medium": 123,
"high": 123,
"none": 123
},
"assignee": {
"me": 123,
"unassigned": 123,
"users": [
{
"uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"full_name": "<string>",
"email": "<string>",
"count": 123
}
]
},
"has_case": 123,
"min_size": {
"10": 123
}
}
}
}q와 동일한 상태, 신호, 패턴, 위험 구간 칩이 여기에 포함됩니다.
assignee, priority, risk_min, has_case 파라미터는 counts.facets가 집계하는 담당자, 우선순위, 최소 위험, 연결된 케이스 옵션과 일치합니다.
assignee=me는 콘솔 멤버 토큰이 필요하며, API 키를 사용하면 400을 반환합니다.
공유 모드와 조직 간 신호
모든 응답에는 조직의sharing_mode, cross_org_available, cross_org_unavailable_reason이 포함됩니다.
| 필드 | 의미 |
|---|---|
sharing_mode | 조직의 조직 간 공유 모드입니다. global만 조직 간에 네트워크를 비교하며, private과 off는 네트워크를 조직 자체의 이력으로만 제한합니다. |
cross_org_available | 조직 간 신호가 조직에 적용되는지 여부입니다. 이를 사용하려면 Enterprise 요금제와 global 공유 모드가 모두 필요합니다. |
cross_org_unavailable_reason | 공유 모드와 관계없이 요금제에 조직 간 사기 네트워크가 포함되지 않으면 plan입니다(Enterprise 요금제가 필요합니다). 요금제에는 포함되지만 공유 모드가 private 또는 off이면 sharing_mode입니다. cross_org_available이 true이면 null입니다. |
global이어도 이유는 plan입니다.
개수와 summary 파라미터
kpis는 필터와 일치하는 네트워크를 집계하고, counts는 애플리케이션이 볼 수 있는 모든 네트워크를 집계합니다. 따라서 두 값 모두 페이지 자체보다 비용이 더 많이 듭니다.
페이지와 count만 필요하면 summary=false를 전달하십시오. 이 경우 응답에서 kpis와 counts가 생략됩니다.
summary는 true 또는 false만 허용하며, 다른 값은 400을 반환합니다.
counts에는 목록의 보기와 필터 옵션에 해당하는 숫자가 들어 있으며, 각 네트워크는 한 번만 집계됩니다.
| 키 | 집계 대상 |
|---|---|
scopes | 볼 수 있는 모든 네트워크(all)를 transactions(모든 멤버가 거래 당사자인 네트워크)와 identity(그 밖의 모든 네트워크)로 나눈 수입니다. |
views | 선택한 scope(all) 안에서 볼 수 있는 네트워크를 상태별(active, in_review, resolved, dismissed), 호출한 콘솔 멤버에게 할당된 네트워크(mine), 그리고 high_risk(위험 점수 80 이상이며 dismissed 상태가 아닌 네트워크)로 집계합니다. |
facets | 선택한 scope 및 status 보기(total)에 포함된 네트워크를 최근 활동(last_activity_days: 7, 30, 90), 최소 위험(risk_min: 50, 80), 신호 유형, 우선순위(none 포함), 담당자(me, unassigned, 그리고 users의 담당자마다 항목 하나), 애플리케이션이 케이스를 연 네트워크(has_case), 멤버가 10명 이상인 네트워크(min_size)로 집계합니다. |
scope와 status 이외의 필터는 counts를 변경하지 않습니다.
API 키의 경우 콘솔 멤버가 호출하지 않으므로 views.mine과 facets.assignee.me는 항상 0입니다.
접근 권한
Networks endpoint에는 전체 접근 권한이 있는 API 키가 필요합니다. 제한된 접근 권한을 가진 키는403을 받습니다.
콘솔 멤버 토큰에는 list:networks가 필요합니다.
조직에서 Networks가 활성화되지 않으면 모든 Networks endpoint가 "code": "networks_not_entitled"와 함께 403을 반환합니다.
관련 항목
인증
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 를 참고하십시오.
쿼리 매개변수
포함할 쉼표로 구분된 상태: active,in_review,resolved,dismissed. dismissed를 제외하려면 이 파라미터를 생략하십시오.
transactions는 멤버가 모두 거래 당사자인 네트워크를 유지하고, identity는 그 외의 모든 네트워크를 유지합니다. 둘 다 유지하려면 생략하십시오. 이는 counts.views 및 counts.facets의 범위도 좁힙니다. 다른 값은 400을 반환합니다.
identity, transactions 쉼표로 구분된 시그널 유형: ip_address,device,face,document_number,phone,email,address.
쉼표로 구분된 패턴 유형입니다(예: exact_same_device,same_email).
쉼표로 구분된 구간: low,medium,high.
최소 멤버 수입니다.
최대 멤버 수.
쉼표로 구분된 담당자: unassigned, 멤버 이메일(대소문자 구분 없이 일치) 또는 호출한 콘솔 멤버를 나타내는 me. 네트워크는 어떤 값과도 일치합니다. me는 콘솔 멤버 token이 필요합니다. API 키는 400 {"assignee": ["\"me\" needs a user token; an API key has no assignee identity."]}을 수신합니다.
쉼표로 구분된 우선순위: low, medium, high, 또는 우선순위가 없는 네트워크의 경우 none입니다. 다른 모든 값은 400 {"priority": "Unknown priority: <values>."}을 반환합니다.
최소 위험 점수로, 0에서 100 사이의 정수입니다. 정수가 아닌 값은 400 {"risk_min": "Use a whole number from 0 to 100."}을 반환합니다.
0 <= x <= 100true는 애플리케이션에서 케이스를 생성한 네트워크만 유지하고, false는 그 외의 네트워크를 유지합니다. 그 외의 값은 무시됩니다.
last_activity_at의 하한값(ISO 8601 날짜 또는 날짜/시간).
first_activity_at의 상한(ISO 8601 날짜 또는 날짜/시간)입니다.
네트워크 이름, 멤버 이름, network_id(N-0001) 및 정확한 pattern_type 토큰에 대한 자유 형식 검색입니다.
risk_score, -risk_score, last_activity_at, -last_activity_at, first_activity_at, -first_activity_at, network_number, -network_number 중 하나입니다. 기본값은 -risk_score,-last_activity_at입니다.
페이지 크기(1-500)입니다. 기본값은 100입니다.
1 <= x <= 500첫 번째 레코드의 0부터 시작하는 오프셋입니다.
x >= 0false는 kpis 및 counts 없이 페이지와 해당 count만 반환합니다. 기본값은 true입니다. true 또는 false 이외의 값은 400을 반환합니다.
응답
조직의 공유 모드 및 조직 간 가용성을 포함하는 페이지 단위로 제공되는 네트워크 목록이며, summary=false가 아닌 경우 kpis 및 counts도 함께 제공됩니다.
다음 페이지의 오프셋이며, 마지막 페이지에서는 null입니다.
Show child attributes
Show child attributes
조직의 조직 간 공유 모드입니다. global만 조직 간 네트워크를 비교하며, private 및 off는 해당 조직 자체의 이력으로만 제한합니다.
off, private, global "global"
조직 간 신호가 이 조직에 적용되는지 여부입니다. 엔터프라이즈 플랜과 global 공유 모드가 모두 필요합니다.
true
조직 간 신호가 적용되지 않는 이유(확인 순서 기준). plan: 공유 모드와 관계없이 조직의 요금제에 조직 간 사기 방지 네트워크가 포함되어 있지 않습니다(Enterprise 요금제 필요). sharing_mode: 요금제에는 포함되어 있으나 공유 모드가 private 또는 off입니다. cross_org_available이 true인 경우 null입니다.
plan, sharing_mode null
각 키는 현재 필터와 일치하는 결과에 대한 {value, delta}입니다. summary=false인 경우 생략됩니다.
Show child attributes
Show child attributes
목록의 보기 및 필터 옵션에 대한 네트워크 수이며, 각 네트워크는 한 번씩 계산됩니다. summary가 false가 아닐 때만 반환됩니다. scopes는 애플케이션에 표시되는 모든 네트워크를 계산합니다. views는 선택한 scope 내에서 표시되는 네트워크를 계산합니다. facets는 선택한 scope 및 status 보기의 네트워크를 계산합니다(기각된 네트워크는 status에 포함되지 않는 한 제외됩니다). 다른 목록 필터는 이 계산에 영향을 주지 않습니다.
Show child attributes
Show child attributes