{"openapi":"3.0.3","info":{"title":"APICK 은행코드 조회","version":"1.0.0","description":"계좌 관련 API에 쓰는 은행 코드와 은행명 목록을 조회합니다."},"servers":[{"url":"https://apick.app"}],"paths":{"/rest/bank_code":{"post":{"summary":"은행코드 조회","description":"계좌 관련 API에 쓰는 은행 코드와 은행명 목록을 조회합니다.","security":[{"bearerAuth":[]}],"parameters":[],"responses":{"200":{"description":"서비스별 성공·처리 상태 응답","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"result":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","description":"은행 코드 3자리입니다. 앞자리 0까지 문자열 그대로 쓰세요. 예: 004(국민), 088(신한), 050(저축은행)"},"name":{"type":"string","description":"은행명입니다. 계좌 API의 bank_name에 넣을 때는 이 값을 그대로 씁니다. 예: 국민, 카카오뱅크"}}},"description":"은행 코드 목록입니다. 항목마다 코드(code)와 은행명(name)이 한 쌍으로 들어 있습니다."},"success":{"type":"integer","description":"처리 상태입니다. 1이면 정상 응답, 0이면 실패 응답입니다."},"error":{"type":"string","description":"실패 사유 문구입니다. 정상 응답에는 없습니다. \"알 수 없는 이유로 금융정보를 불러오지 못했습니다.\"가 오면(HTTP 424) 잠시 후 다시 요청하세요."}},"description":"은행 코드 목록 묶음입니다. 실패하면 result 대신 error 문구가 들어 있습니다."},"api":{"type":"object","properties":{"success":{"type":"boolean","description":"요청을 정상적으로 받아 처리했는지 여부입니다. 목록을 받았는지는 data.result로 확인하세요."},"cost":{"type":"integer","description":"이번 호출에서 차감된 포인트입니다. 실패 응답은 0입니다."},"ms":{"type":"integer","description":"요청을 받아 응답을 만들기까지 걸린 시간(밀리초)입니다. 네트워크 왕복 시간은 포함되지 않습니다."},"pl_id":{"type":"integer","description":"포인트 차감 기록 번호입니다. 차감이 없으면 -1이거나 필드가 없습니다."}},"description":"호출 공통 정보입니다. 처리 여부·차감 포인트·처리 시간·차감 기록 번호가 들어 있습니다."}}}}}},"default":{"description":"HTTP 상태 및 서비스 오류코드 확인","content":{"application/json":{"schema":{"type":"object"}}}}},"requestBody":{"required":false,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{}}}}}}}},"x-code-tables":[],"x-service-errors":[],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}}}