메인 콘텐츠로 건너뛰기
GET
curl
네트워크를 그래프로 조회합니다. 네트워크에 속한 각 벤더 사용자, 벤더 기업, 거래 당사자에 대해 주체 노드를 반환하고, 이들을 연결하는 공유 기기, IP, 얼굴, 문서 번호, 전화번호, 이메일, 주소 값마다 신호 노드를, 그리고 이들 사이의 멤버십 관계마다 엣지를 반환합니다. depth를 사용하면 focus_kind/focus_id로 지정한 주체에서 몇 홉까지 반환할지 제한할 수 있습니다. 콘솔의 그래프 보기는 이 기능을 사용해 전체 네트워크를 불러오는 대신 한 신청자의 직접 연결만 확대해서 보여 줍니다. depth를 생략하거나(또는 all을 전달하면) 전체 연결 범위가 반환됩니다. 제한된 요청에서 일부가 잘렸는지는 truncated로 확인합니다.

관련 문서

인증

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 를 참고하십시오.

경로 매개변수

organization_id
string<uuid>
필수

조직 UUID입니다.

application_id
string<uuid>
필수

애플리케이션 UUID입니다.

network_uuid
string<uuid>
필수

네트워크 UUID입니다.

예시:

"n3a5e000-0000-4000-8000-000000000001"

쿼리 매개변수

depth
enum<string>

포함할 대상 주체로부터의 홉 수입니다. 기본값은 전체(무제한)입니다.

사용 가능한 옵션:
1,
2,
3,
all
focus_kind
enum<string>

그래프의 중심이 될 주체 유형입니다. focus_id와 함께 제공해야 합니다. 깊이가 제한되어 있고 둘 다 제공되지 않은 경우 임의의 멤버로 기본 설정됩니다.

사용 가능한 옵션:
vendor_user,
vendor_business,
transaction_party
focus_id
string<uuid>

그래프의 중심이 될 주체 UUID입니다.

응답

네트워크 그래프입니다.

network
object
depth
integer | null

적용된 유효 깊이이며, 제한이 없는 경우(depth=all) null입니다.

truncated
boolean

인접 노드가 깊이 제한으로 인해 잘린 경우 true입니다.

nodes
object[]
edges
object[]
metrics
object
마지막 수정일 2026년 11월 7일