API 레퍼런스
API 인증
세션 발급은 기관 키, 업무 API는 Bearer 세션 토큰을 사용합니다.
기관 서버 인증
POST /v1/sessions는 x-wss-institution-key 헤더를 사용합니다. 기관 키는 기관 백엔드의 비밀 설정에 보관하고 브라우저나 앱 번들에 포함하지 않습니다.
x-wss-institution-key: YOUR_INSTITUTION_KEY
Content-Type: application/json고객 세션 인증
세션 생성 후 업무 API는 발급받은 sessionToken을 Bearer 토큰으로 사용합니다.
Authorization: Bearer YOUR_SESSION_TOKEN세션의 기본 수명은 900초입니다. 응답 expiresAt을 기준으로 만료를 처리하세요. 서버는 서명·형식·프로토콜·만료를 검사하고, 발급 시각이 현재보다 30초 넘게 미래인 토큰을 거절합니다.
공통 전송 규칙
- 요청과 응답은
application/json입니다. - BFF 요청 본문 한도는 16,384바이트입니다.
- 응답은
Cache-Control: no-store입니다. - 허용되지 않은 Origin 요청은 403
origin_not_allowed를 반환합니다. - OPTIONS 요청은 204로 응답합니다.