메인 콘텐츠로 건너뛰기
GET
curl
Didit의 List Bank Connections endpoint는 상태, 액세스, 은행, 국가, 자체 참조 및 동의 만료일을 기준으로 필터링된 연결 목록을 반환합니다. consent_expires_before를 사용하면 갱신이 필요한 동의를 찾을 수 있고, end_user_reference를 사용하면 한 클라이언트의 연결을 찾을 수 있습니다. 목록은 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 를 참조합니다.

쿼리 매개변수

status
enum<string>

이 상태의 연결만 해당합니다.

사용 가능한 옵션:
pending,
active,
renewal_required,
paused,
revoked,
deleted,
failed
access
enum<string>

이 액세스 모드만 해당합니다.

사용 가능한 옵션:
one_time,
ongoing
institution_id
string

이 은행만 해당합니다.

Maximum string length: 64
country
string

이 국가의 은행만 해당합니다.

Pattern: ^[A-Z]{3}$
vendor_data
string

이 vendor_data를 가진 연결만 해당합니다.

Maximum string length: 255
end_user_reference
string

이 end_user.reference를 가진 연결만 해당합니다.

Maximum string length: 255

동의가 이 시간 이전에 종료되는 연결만 해당합니다. 예를 들어 갱신 링크를 보낼 때 사용합니다.

created_after
string<date-time>

이 시간 이후에 생성된 연결만 해당합니다.

limit
integer
기본값:100

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

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

이전 페이지의 next_cursor 값인 불투명 커서입니다.

응답

연결 페이지입니다.

연결 페이지입니다.

items
object[]
필수
next_cursor
string | null
필수

다음 페이지를 조회하려면 cursor로 전달합니다. 마지막 페이지에서는 null입니다.

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