에러 코드
실패 응답 형식:
{ "success": false, "error": { "code": "not_found", "message": "채널을 찾을 수 없습니다" } }
| HTTP | code | 의미 |
|---|---|---|
| 400 | bad_request |
잘못된 요청 |
| 401 | unauthorized |
인증 필요/실패(토큰·기기 헤더 없음, 로그인 실패) |
| 403 | forbidden |
접근 불가(비활성 계정 등) |
| 404 | not_found |
리소스 없음 |
| 404 | no_stream |
재생 가능한 스트림 없음/URL 미설정 |
| 409 | conflict |
중복(이미 가입된 이메일 등) |
| 422 | validation |
입력값 검증 실패 |
| 502 | resolve_failed |
토큰형 스트림 발급 실패(방송사 API 오류) |
| 503 | — | 서비스 저하(DB 연결 실패 등, /health) |
권장 처리
401(즐겨찾기/계정): 토큰 재발급 또는 재로그인 유도.resolve_failed/ 재생 중 403:/stations/{id}/stream재호출(토큰 재발급).no_stream: 해당 채널은 아직 스트림 미설정. 목록에서stream.available=false.