메인 콘텐츠로 건너뛰기
GET
curl
Didit의 Travel Rule 전송 내역 API는 거래에 대한 모든 전송 항목을 가장 오래된 순으로 정렬하여 페이지 단위로 반환합니다. 거래 읽기 권한이 있는 x-api-key를 사용하십시오. transaction_id는 Didit 거래 UUID입니다. 거래 또는 이체가 없으면 404가 반환되고, 권한이 부족하면 403이 반환됩니다.

페이지네이션 및 정렬

응답에는 count, next, previous, results가 포함됩니다. limit의 기본값은 100이며 최대 100으로 제한됩니다. offset의 기본값은 0이며 1,000,000을 초과할 수 없습니다. 초과하면 400이 반환됩니다. count는 보통 최대 100으로 제한되므로, 기록이 많은 경우 전체 개수를 정확히 나타내지 않습니다. count 값과 관계없이 next가 null이 될 때까지 따라가며 조회하십시오. 항목은 생성 시각순으로 정렬되며, 시각이 같으면 식별자순으로 정렬됩니다. 각 항목에는 uuid, kind, status, rail, created_at, delivered_at, detail_lines가 있습니다. rail은 EMAIL, TRP, INTERNAL, NETWORK 중 하나이며, 선택되기 전에는 null입니다. detail_lines는 메시지 종류와 상태를 설명하며, 원시 오류나 전송 payload는 포함하지 않습니다.

포함된 이력

거래 상세에는 travel_rule.deliveries의 최신 항목 100개만 포함되며, 오래된 항목부터 표시됩니다. deliveries_truncated는 더 오래된 항목이 생략되었는지 여부를 알려 줍니다. 거래 목록에서는 이 두 이력 필드가 생략됩니다. 기존 delivery 필드는 계속해서 가장 최근 전송을 나타냅니다. 상태의 의미는 전송 및 재시도를 참고하십시오. 거래 상대방 메시지는 별도의 대화 endpoint입니다.

인증

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

경로 매개변수

transaction_id
string<uuid>
필수

해당 이체를 소유한 Didit 고유 거래 UUID입니다.

쿼리 매개변수

limit
integer
기본값:100

페이지당 항목 수. 기본값은 100이며, 더 큰 값은 100으로 제한됩니다. 1,000,000을 초과하는 값은 400을 반환합니다.

필수 범위: 1 <= x <= 1000000
offset
integer
기본값:0

건너뛸 항목 수이며 최대 1,000,000입니다. 더 큰 값은 400을 반환합니다.

필수 범위: 0 <= x <= 1000000

응답

오래된 순으로 정렬된 전송 내역입니다(페이지 단위).

count
integer
필수

count는 보통 100으로 제한되며, 더 큰 기록에 대한 신뢰할 수 있는 총계가 아닙니다. count와 관계없이 next가 null이 될 때까지 따라가십시오.

필수 범위: x >= 0
next
string<uri> | null
필수

다음 페이지 URL이며, 없으면 null입니다.

previous
string<uri> | null
필수

이전 페이지 URL이며, 없으면 null입니다.

results
object[]
필수

생성 시간순으로 오래된 항목부터 정렬되며, 시간이 같으면 식별자순으로 정렬됩니다.

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