메인 콘텐츠로 건너뛰기
GET
네트워크의 이벤트 기록을 조회합니다. contract를 지정하지 않으면 응답은 네트워크 자체의 기록이며, 가장 오래된 순서로 정렬되고 페이지로 나뉘지 않습니다. 네트워크가 처음 감지된 시점, 각 신호가 마지막으로 관찰된 시점, 그리고 가장 최근의 상태 변경과 그 사유가 포함됩니다. 이 응답 형식은 변경되지 않으며, limit, cursor, event_type은 무시됩니다.

타입이 지정된 타임라인

타입이 지정된 타임라인을 조회하려면 contract=2를 전달합니다. 멤버 계정이 수행한 작업과 귀하의 팀이 해당 네트워크에 대해 취한 조치가 추가되며, 최신순으로 한 페이지씩 제공됩니다. contract는 2만 허용하며, 다른 값을 지정하면 400이 반환됩니다. 응답은 {"results": [...], "next_cursor": "..."} 형식입니다. next_cursor가 null이 될 때까지, cursor를 next_cursor 값으로 설정하여 다음 페이지를 조회합니다.

이벤트 유형

note_added 이벤트는 콘솔 멤버에게만 반환되며, API 키에는 절대 반환되지 않습니다. 두 멤버 간의 거래는 각 멤버마다 자체 account와 함께 한 번씩 나타납니다. 해당 거래에 대한 규칙 적중은 한 번만 나타납니다. 로그인 이벤트는 이벤트로 게시한 로그인에만 존재합니다: auth.login, security.login_succeeded 및 이들의 실패 형태.

계정 및 기록

각 멤버 이벤트에는 해당 이벤트가 속한 멤버인 account와, 해당 이벤트를 읽어온 세션, 기업 세션, 거래, 모니터링 이벤트 또는 케이스인 source_ref가 포함됩니다. ownership은 호출한 애플리케이션에 기록이 속하면 owned, 조직 내 다른 애플리케이션에 속하면 organization입니다. route는 기록의 종류, UUID, 애플리케이션을 제공합니다. 모니터링 이벤트나 케이스의 source_ref에는 route가 없습니다. 네트워크 자체 이벤트에는 account와 source_ref가 모두 없습니다.

관련 문서

인증

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"

쿼리 매개변수

contract
enum<string>

2는 유형이 지정된 타임라인을 반환합니다. 기본 타임라인의 경우 생략합니다. 그 외의 값은 400을 반환합니다.

사용 가능한 옵션:
2
limit
integer
기본값:100

유형별 타임라인 전용입니다. 페이지당 이벤트 수이며, 1에서 500 사이입니다. 기본값은 100입니다.

필수 범위: 1 <= x <= 500
cursor
string

유형별 타임라인 전용입니다. 이전 페이지의 next_cursor입니다. 유효하지 않거나 비어 있는 커서는 400을 반환합니다.

event_type
enum<string>[]

유형별 타임라인 전용입니다. 유지할 이벤트 유형으로, 반복하거나 쉼표로 구분하여 최대 20개 값까지 지정할 수 있습니다. 기본값은 모든 유형입니다.

Maximum array length: 20
사용 가능한 옵션:
network_detected,
signal_observed,
network_active,
network_in_review,
network_resolved,
network_dismissed,
verification_attempt,
transaction,
login,
rule_hit,
case_linked,
note_added

응답

contract 미지정 시: 페이지 매김 없는 {results}(오래된 순)입니다. contract=2인 경우: {results, next_cursor}(최신순)입니다.

contract 미지정 시: 네트워크 자체 이벤트가 페이지네이션 없이 오래된 순서대로 반환됩니다.

results
object[]
마지막 수정일 2026년 11월 7일