API 테스트
82bank API 는 관리 화면에서 먼저 등록한(은행 확인을 통과한) 계좌로 씁니다. 지금 누구나 등록할 수 있는 은행은 신한은행(간편조회서비스, 이용자 ID 로그인)과 농협은행(빠른조회)입니다. 아래 순서대로 부르면 은행 비밀번호를 다시 보내지 않고도 API 가 어떻게 답하는지 볼 수 있습니다.
- 관리 화면 [계좌관리]에서 계좌를 등록합니다. 등록할 때 은행에 한 번 물어 맞을 때만 저장하고, 최근 30일 치를 가져옵니다.
- [API 키]에서 키를 만듭니다. 시크릿(
sk_…)은 이때 한 번만 보입니다. - 아래처럼
/v1/ping으로 키를 확인하고,/v1/accounts에서 계좌id를 받아 저장 내역을 가져옵니다. 이 셋은 은행에 가지 않습니다. - 새 거래를 바로 보고 싶으면
POST /v1/accounts/{id}/refresh로 수집을 요청합니다(저장된 인증정보로 수집, 같은 계좌 5분에 한 번). 몇 분 뒤 저장 내역을 다시 부르면 됩니다.
# 1) 키 확인
curl -H "Authorization: Bearer bk_여기에_API_키:sk_여기에_시크릿" https://82bank.app/v1/ping
# 2) 등록해 둔 계좌 목록(인증정보는 들어 있지 않습니다)
curl -H "Authorization: Bearer bk_여기에_API_키:sk_여기에_시크릿" https://82bank.app/v1/accounts
# 3) 그 계좌에 저장된 오늘 입금(은행에 가지 않습니다)
curl -H "Authorization: Bearer bk_여기에_API_키:sk_여기에_시크릿" \
"https://82bank.app/v1/accounts/acc_…/transactions?from=2026-11-18&to=2026-11-18&type=deposit"
실시간 조회(/v1/transactions/login)는 요청에 은행 로그인 비밀번호를 담아 은행에 바로 보냅니다. 은행 로그인 비밀번호를 틀리면 은행 계정이 잠길 수 있습니다. 82bank 는 같은 ID 로 두 번 실패하면 더 시도하지 않습니다. 시험할 때는 은행에 비밀번호를 보내지 않는 저장 내역과 지금 수집부터 쓰세요.
API 키와 시크릿은 브라우저 주소창이나 화면 공유에 남지 않게 터미널·서버에서만 쓰세요. 응답 항목과 오류 코드는 API 문서에 있습니다.