메인 콘텐츠로 건너뛰기
GET
curl
Didit의 Sync Transactions endpoint는 커서 이후 연결된 계좌의 거래 중 변경된 내용을 반환합니다: added, modified, removed. 커서를 비워 두면 reset: true와 함께 모든 거래가 반환됩니다. has_more: false가 포함된 응답을 받은 후에만 next_cursor를 저장해야 합니다. 회계를 위한 지속적인 은행 거래 피드를 참조하십시오.

인증

x-api-key
string
header
필수

귀사 애플리케이션의 API 키입니다. Business Console의 Developers -> API keys에서 확인할 수 있습니다. 기본 키는 모든 권한을 가집니다. 명명된 키는 범위를 지정할 수 있습니다. 리소스별로 권한 없음, 읽기 또는 쓰기를 설정할 수 있고, 일부 워크플로나 승인된 세션으로 제한할 수 있으며, 허용된 IP 목록으로 제한할 수 있고, 만료일을 설정할 수 있습니다. 401은 키가 잘못되었거나, 취소되었거나, 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스 또는 작업에 대한 권한이 없거나, 요청이 IP 목록 밖의 주소에서 왔음을 의미합니다. 세션 경로에서 발생한 404는 세션이 키의 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 동영상 및 PDF URL을 null로 받으며, 세션 쓰기 권한이 없는 키는 세션 링크와 토큰을 null로 받습니다. 자세한 내용은 https://docs.didit.me/console/api-keys 를 참조합니다.

경로 매개변수

id
string<uuid>
필수

연결 ID입니다.

쿼리 매개변수

cursor
string

저장해 둔 next_cursor입니다. 비어 있거나 생략하면 처음부터 시작합니다.

limit
integer
기본값:100

페이지 크기이며, 1~500 사이입니다. 기본값은 100입니다.

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

has_more가 true인 동안 같은 읽기를 계속합니다.

응답

변경 사항 페이지입니다.

커서 이후 연결 거래 내역의 변경 사항입니다. 빈 커서를 사용하면 현재 모든 거래가 added로 반환됩니다. 한 번의 읽기에서 가져온 모든 페이지는 동일한 스냅샷을 반영하며, 그 사이에 발생한 변경 사항은 다음 읽기에서 전달됩니다.

added
object[]
필수

추가할 거래입니다. 첫 번째 조회(커서가 없거나 reset 이후)에서는 조회가 시작될 때 연결에 있던 모든 거래가 포함되며, 페이지를 넘기는 동안 동기화가 실행되더라도 각 거래는 정확히 한 번, 현재 상태로 담깁니다. 이후 조회에서는 커서 이후 새로 생긴 거래와 대기 중인 거래를 대체하는 확정 거래가 포함됩니다.

modified
object[]
필수

커서 이후 변경된 거래를 현재 상태 그대로 담습니다. 각 거래를 id 기준으로 upsert하여 적용하십시오. 첫 번째 조회를 페이지 단위로 받는 동안 이미 받은 거래라도 그사이에 변경되었다면 여기에 다시 나타나며, 은행의 정정 내역도 여기에 도착합니다.

removed
object[]
필수

더 이상 존재하지 않는 거래이며 reason이 함께 제공됩니다. 보유하지 않은 id는 무시하십시오. 첫 번째 조회를 페이지 단위로 받는 동안 삭제된 거래는 여전히 added로 한 번 전달되었고, 다음 조회에서 여기에 도착합니다.

has_more
boolean
필수

다음 페이지가 더 있는 동안 true입니다. has_more: false인 응답을 받은 후에만 next_cursor를 저장하십시오. 페이징 도중 실패하면 저장해 둔 커서부터 다시 시작하십시오.

next_page_token
string | null
필수

has_more가 true인 동안 이 읽기를 계속합니다.

next_cursor
string | null
필수

피드의 영속적인 체크포인트이며, 마지막 페이지에서만 반환됩니다. 불투명한 값이며 애플리케이션, 환경 및 연결에 바인딩됩니다. 90일 동안 재생할 수 있습니다. 첫 번째 읽기에서는 읽기가 시작된 시점을 표시하므로, 그 사이에 변경된 내용은 다음 읽기에서 전달됩니다.

reset
boolean
필수

빈 커서에서 시작하는 모든 초기 조회(부트스트랩)에서는 true입니다. 결과를 기존 복사본에 추가하지 말고 복사본을 결과로 교체하십시오.

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