API 레퍼런스
오류 처리
HTTP 오류와 지갑 브리지 오류를 각각 처리합니다.
HTTP 오류
명시적 오류 응답은 { "error": "오류 코드" }입니다. error는 필수 string이고 null을 허용하지 않습니다.
| 코드 | 상태 | 확인할 내용 |
|---|---|---|
| origin_not_allowed | 403 | 허용 Origin 설정 |
| institution_auth_required | 401 | 기관 서버 키 |
| tenant_not_found | 404 | 기관 식별자 |
| key_adapter_not_allowed | 400 | 기관의 키 어댑터 정책 |
| session_policy_mismatch | 403 | 세션의 어댑터와 현재 정책 일치 여부 |
| wallet_query_provider_unavailable | 503 | 지갑 조회 공급자 가용성 |
| identity_provider_unavailable | 503 | 고객 식별 공급자 가용성 |
| production_wallet_query_provider_required | 503 | 개발 공급자를 운영 환경에서 사용했는지 여부 |
| not_found | 404 | 요청 경로 |
| request_rejected | 400 또는 401 | 일반 예외. 세션·토큰·만료 관련은 401, 그 외는 400 |
등록 API는 별도의 입력·정책·호출 제한 오류를 가집니다. 이 표는 전체 등록 API 오류 목록이 아닙니다.
브리지 오류와 고객 취소
took-wss:error의 code는 HTTP 응답의 error와 별개입니다. 이벤트를 수신해 호스트 화면에서 오류 상태를 표시하세요. 고객 취소 또는 미구현 호스트 콜백은 cancelled 결과로 처리하며 승인 성공으로 바꾸지 않습니다.