메인 콘텐츠로 건너뛰기
POST
curl
애플리케이션의 태그 중 하나를 네트워크에 추가합니다. 예를 들어 후속 조치가 필요한 네트워크를 표시하거나 팀이 내린 결론을 기록할 때 사용할 수 있습니다. 애플리케이션 태그의 UUID를 tag_uuid로 전달합니다. 다른 애플리케이션에 속한 태그를 지정하면, 존재하지 않는 태그와 마찬가지로 404를 반환합니다. 응답은 전체 네트워크 상세 정보이며, 태그가 추가된 경우 201을, 태그가 이미 네트워크에 있었던 경우 200을 반환합니다. 같은 태그로 다시 호출해도 변경되는 것은 없으므로 안전하게 재시도할 수 있습니다. tags에는 애플리케이션의 태그 중 네트워크에 추가된 태그가 가장 오래된 순으로 나열됩니다. added_by는 API 키가 태그를 추가한 경우 null이고, 콘솔 멤버가 추가한 경우 해당 멤버의 이메일 주소입니다. 네트워크의 fraud_tags(멤버가 보유한 태그)는 영향을 받지 않습니다.

관련 문서

인증

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입니다.

예시:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

본문

application/json
tag_uuid
string<uuid>
필수

애플리케이션 태그 중 하나의 UUID입니다.

응답

태그가 이미 네트워크에 존재하여 그대로 유지됩니다. 네트워크 세부 정보를 반환합니다.

네트워크 세부 정보와 조직의 공유 모드, 교차 조직 신호 적용 여부, 네트워크에서의 애플리케이션 태그, 멤버 결과 및 패턴 점수입니다.

uuid
string<uuid>
network_id
string

사람이 읽을 수 있는 조직별 순차 ID(예: N-0001)입니다.

name
string | null
status
enum<string>

네트워크 라이프사이클 상태입니다. 네트워크 내부의 신청자별 outcome_status(approved/in_review/declined/not_completed)와 구별됩니다.

사용 가능한 옵션:
active,
in_review,
resolved,
dismissed
risk
object
pattern_types
enum<string>[]

이 네트워크에서 감지된 클러스터링 패턴입니다.

사용 가능한 옵션:
exact_same_device,
similar_device,
same_ip_address,
same_address,
similar_selfie_backgrounds,
similar_poa_documents,
same_document_number,
same_phone_number,
same_email
signal_types
enum<string>[]

이 네트워크에 존재하는 고유한 신호 유형들입니다.

사용 가능한 옵션:
ip_address,
device,
face,
document_number,
phone,
email,
address
member_counts
object

카테고리별 멤버 수(예: 전체, outcome_status별).

member_status
object

outcome_status별 멤버 내역입니다.

signal_coverage
object

이 네트워크 멤버들의 signal_type별 적용 범위입니다.

first_activity_at
string<date-time> | null
last_activity_at
string<date-time> | null
stats
object

네트워크에 대한 집계 통계입니다(예: 멤버 총수).

fraud_tags
object[]

네트워크에 나타난 사기 패턴 태그입니다.

risk_signals
object

위험 신호 요약: residential_proxy_reuse, email_intelligence, phone_intelligence.

reviewed_at
string<date-time> | null
reviewed_by
string | null
review_reason
string | null
notes_count
integer
read-only

이 조사에 포함된 비공개 분석가 메모 수입니다.

필수 범위: x >= 0
sharing_mode
enum<string>

조직의 조직 간 공유 모드입니다. global만 조직 간 네트워크를 비교하며, private 및 off는 해당 조직 자체의 이력으로만 제한합니다.

사용 가능한 옵션:
off,
private,
global
예시:

"global"

cross_org_available
boolean

조직 간 신호가 이 조직에 적용되는지 여부입니다. 엔터프라이즈 플랜과 global 공유 모드가 모두 필요합니다.

예시:

true

cross_org_unavailable_reason
enum<string> | null

조직 간 신호가 적용되지 않는 이유(확인 순서 기준). plan: 공유 모드와 관계없이 조직의 요금제에 조직 간 사기 방지 네트워크가 포함되어 있지 않습니다(Enterprise 요금제 필요). sharing_mode: 요금제에는 포함되어 있으나 공유 모드가 private 또는 off입니다. cross_org_available이 true인 경우 null입니다.

사용 가능한 옵션:
plan,
sharing_mode
예시:

null

tags
object[]

네트워크상에서 귀하 애플리케이션의 태그로, 오래된 순으로 정렬됩니다. 각 애플리케이션은 자신의 태그만 볼 수 있습니다. fraud_tags는 별개이며 변경되지 않습니다. 이는 네트워크 멤버들이 보유한 태그입니다.

outcomes
object

네트워크의 개인 및 기업의 현재 상태입니다. 조회 가능한 각 멤버는 결정에 도달한 가장 최근 인증 상태에 따라 한 번씩 카운트됩니다. 거래 당사자는 카운트되지 않습니다.

patterns
object[]

전체 네트워크에 걸친 패턴 점수입니다. 현재는 background 항목 하나만 제공됩니다.

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