연동 계좌 - 신한은행 간편조회
1. 신한은행 연동 계좌 목록shinhan_ easy. linked_ accounts. list
MCP 도구 이름 shinhan_
POSThttps:// api. xdata. kr/ v1/ jobsX-Env-Scope: real_test
현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.
이 호출자가 신한은행 계좌로 등록한 연동과 그 아래 계좌를 나열합니다.연동의 account_link_id 와 계좌의 bank_account_credential_id 를 함께 돌려주므로, 계좌 목록 조회와 거래내역 조회를 부르기 전에 두 값을 얻는 데 씁니다.기관에는 접속하지 않고 XBOSS 에 등록된 기록만 읽으며, 계좌번호는 가린 값으로 나옵니다. 기관에서 실제 계좌를 가져오는 것은 계좌 목록 조회(shinhan_easy.accounts.list)입니다.
- 이 API 는 기관 연동과 기관 로그인이 필요 없습니다. 기관 자격증명을 등록하지 않아도 호출할 수 있고, account_link_id 는 보내지 않습니다.
Request
| 순번 | 변수명 | 필수 | 설명 |
|---|---|---|---|
| Authorization | Y | API 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다. | |
| X- | Y | 호출 환경입니다.
| |
| Idempotency- | Y | 재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다. | |
| Content- | Y | 요청 본문 형식입니다.
| |
| X- | N | 추적 아이디입니다. 지정하지 않으면 서버가 발급합니다. |
| 순번 | 변수명 | 타입 | 필수 | 설명 |
|---|---|---|---|---|
| provider | string | Y | 호출할 기관입니다.
| |
| action | string | Y | 호출할 작업입니다.
| |
| params | object | N | 작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다. | |
| encrypted_ | object | N | 민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다. |
추가 파라미터가 없습니다. params 는 {} 로 보냅니다.
curl --request POST \
--url 'https://api.xdata.kr/v1/jobs' \
--header 'Authorization: Basic {base64(client_id:client_secret)}' \
--header 'X-Env-Scope: real_test' \
--header "Idempotency-Key: list-$(date +%s)-$RANDOM" \
--header 'Content-Type: application/json' \
--data '{
"provider": "shinhan_easy",
"action": "shinhan_easy.linked_accounts.list",
"params": {}
}'Response
| 순번 | 변수명 | 타입 | 설명 |
|---|---|---|---|
| success | boolean | 목록을 돌려줬다는 표지입니다. 항상 true 입니다. | |
| provider | string | 연동을 가려낸 상품 구분 값입니다. 이 작업에서는 항상 shinhan_easy 입니다(호출한 작업 이름의 앞부분). | |
| links | array | 이 계정이 이 상품에 연결해 둔 연동 목록입니다. 사용 중인 연동만 담고 최근에 만든 연동이 앞에 옵니다. 연동이 없으면 빈 배열입니다. | |
| links[]. | string | 연동 ID 입니다. 이 상품의 다른 작업을 부를 때 account_link_id 로 보냅니다. | |
| links[]. | string | null | 연동에 붙인 표시 이름입니다. 이름이 없으면 null 입니다. | |
| links[]. | array | 이 연동에 등록된 계좌 목록입니다. 사용 중인 계좌만 담고 최근에 등록한 계좌가 앞에 옵니다. | |
| links[]. | string | 계좌 ID 입니다. 계좌를 고르는 작업을 부를 때 bank_account_credential_id 로 보냅니다. | |
| links[]. | string | 가려진 계좌번호입니다. 전체 번호는 돌려주지 않습니다. | |
| links[]. | string | 계좌의 상태입니다. 사용 중인 계좌만 담으므로 항상 ACTIVE 입니다. | |
| link_ | number | links 에 담긴 연동의 수입니다. | |
| account_ | number | 모든 연동의 accounts 에 담긴 계좌의 총 수입니다. | |
| truncated | boolean | 늘 false 입니다. 연동을 끝까지 모두 읽어 보내므로 빠지는 연동이 없고, 예전 응답과 맞추려고 남겨 둔 칸입니다. |
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
"success": "<boolean>",
"provider": "<string>",
"links": [
{
"account_link_id": "<string>",
"display_label": "<string | null>",
"accounts": [
{
"bank_account_credential_id": "<string>",
"masked_account_no": "<string>",
"status": "<string>"
}
]
}
],
"link_count": "<number>",
"account_count": "<number>",
"truncated": "<boolean>"
}