연동 개요
방식REST API + WebSocket
Base URLhttps://api.webcash.co.kr/cms/v1
응답 포맷JSON
버전v1 (안정) / v2 (베타)
인증 방식
방식Bearer Token (JWT)
헤더Authorization: Bearer {token}
발급웹케시 파트너포털 → API 키 발급
만료액세스 토큰 1시간 / 리프레시 30일
주요 API
POST/query자연어 질의 처리
GET/accounts계좌 목록 조회
GET/accounts/{id}/balance잔액 조회
POST/transfer이체 실행
GET/analytics자금 분석 리포트
WS/stream실시간 응답 스트리밍
연동 예시
# 자연어 질의
curl -X POST \
https://api.webcash.co.kr/cms/v1/query \
-H "Authorization: Bearer {token}" \
-H "Content-Type: application/json" \
-d '{"query":"이번 달 지출 내역 보여줘",
"product":"branchq"}'
# 응답
{
"answer": "5월 지출 총 ₩2.4억...",
"sql": "SELECT SUM(amount)...",
"data": [...]
}
지원 환경 / SDK
Java SDK
Python SDK
Node.js SDK
REST
WebSocket
Spring Boot
보안 / 규격
전송 암호화TLS 1.3
데이터 암호화AES-256-GCM
감사 로그전 거래 이력 보관 (5년)
준수 규격전자금융거래법, ISO 27001