GuidesAPI GuideChangelog
Log In
API Guide

오류 코드

오류가 나면 HTTP 상태 코드와 함께 JSON 을 돌려줍니다. 어느 단계에서 막혔는지에 따라 형식이 조금 다릅니다.

오류 응답 형식

인증 · 권한 단계

토큰과 권한을 먼저 확인하는 단계입니다. 여기서 막히면 API 까지 요청이 가지 않습니다.

{
  "message": "Access token is missing",
  "status": 401,
  "errors": [],
  "code": "G001",
  "timestamp": "2026-10-28T16:07:44.288Z",
  "traceId": "3f9c2a7e-5b1d-4c8a-9e6f-2d7b8a1c4e90"
}

API 처리 단계

요청 값이나 데이터 문제로 실패한 경우입니다.

{
  "message": "searchStartDt 은 UTC(Z) ISO-8601 형식이어야 합니다.",
  "status": 400,
  "errors": [],
  "code": "C001",
  "timestamp": "2026-10-24T03:15:20Z",
  "traceId": "3f9c2a7e-5b1d-4c8a-9e6f-2d7b8a1c4e90"
}
필드설명
code오류 코드. 아래 표 참고. 분기 처리는 이 값으로 하세요
message사람이 읽는 설명. 문구는 바뀔 수 있습니다
statusHTTP 상태 코드와 같은 값
errors파라미터 검증 오류 상세 {field, value, reason}. 없으면 []
timestamp오류 발생 시각(UTC). 단계에 따라 초 또는 밀리초까지 표시됩니다
traceId요청 추적 ID. 응답 헤더 X-Request-Id 와 같은 값입니다. 문의할 때 함께 알려 주세요

인증 · 권한 오류

codeHTTP언제대응
G001401Authorization 헤더가 없음Bearer {accessToken} 추가
G002401토큰이 올바르지 않음 (형식 오류, 위조, Bearer 접두사 누락)토큰 다시 발급
G003401토큰 만료 (발급 후 1시간)토큰 다시 발급
G004401폐기된 토큰 (secret 재발급·폐기 이후)새 secret 으로 토큰 발급
G005403이 API 를 사용할 권한이 없음모비두 운영팀에 권한 확인 요청
-429호출 한도 초과 (본문 없음)Retry-After 초 후 재시도. 호출 제한 참고
G009503인증 시스템 일시 장애잠시 후 재시도

게이트웨이 일시 오류

API 서버까지 요청을 전달하는 중에 문제가 생기면 게이트웨이가 직접 응답합니다. 본문 형식은 인증 · 권한 단계 오류와 같습니다.

codeHTTP언제대응
G011503요청이 몰려 처리 대기열이 가득 참잠시 후 재시도. 반복되면 호출 간격을 늘려 주세요
G012504API 서버가 60초 안에 응답하지 못함조회 기간을 줄여 다시 시도. 반복되면 traceId 와 함께 문의
G013502API 서버에 연결하지 못함잠시 후 재시도. 반복되면 traceId 와 함께 문의

API 처리 오류

codeHTTP언제대응
C001400필수 파라미터 누락, 값 형식 오류. 계정·방송 API 는 x-api-version 헤더 누락·불일치도 이 코드errors·message 확인 후 수정
C005400허용하지 않는 값 (예: 정해진 값 외의 broadcastStatus)허용 값 확인
OA001400기간이 KST 자정(또는 정시)에 맞지 않음기간 규칙 확인
OA002400조회 기간 31일 초과기간을 나눠 조회
U008403경로의 {partnerId} 가 토큰의 파트너와 다름본인 파트너 ID 사용
P002403사용 중지된 파트너 (라이브 편성)모비두 운영팀에 문의
C003404/sauce-live/ 아래의 없는 경로. 통계 API 는 x-api-version 헤더 누락·불일치도 이 코드경로·헤더 확인 (message 에 필요한 헤더 값 안내)
B001404해당 파트너에 그 방송이 없음 (통계)방송 ID 확인
P001404파트너 정보 없음 (라이브 편성)모비두 운영팀에 문의
B001422같은 시간대 라이브 방송 수가 동시 송출 한도에 도달 (라이브 편성)편성 시각 조정. 한도는 모비두 운영팀에 문의
C002405허용하지 않는 메서드API 페이지의 메서드 사용
OA004502연동 시스템이 일시적으로 응답하지 않음잠시 후 재시도
C004500서버 오류traceId 와 함께 문의
📘

토큰이 없거나 틀린 요청은 경로·헤더가 틀려도 인증 오류(401)가 먼저 납니다. 토큰을 고친 뒤에 404 C003 같은 오류가 보일 수 있습니다.

단, /sauce-live/stats/·/sauce-live/broadcasts/·/sauce-live/users/ 로 시작하지 않는 주소는 인증 전에 404 로 응답하며, 본문에 code 와 traceId 가 없습니다. 주소를 다시 확인해 주세요.

토큰 발급 오류

액세스 토큰 발급 API 의 오류입니다.

응답HTTP언제
{"code": "G010", ...}400x-api-version 헤더가 없거나 값이 다름
{"code": "G014", ...}429clientId 별 토큰 발급 한도(초당 5회) 초과. Retry-After 초 후 재시도
{"error": "invalid_client"}401clientId·clientSecret 이 틀렸거나 폐기됨
{"error": "invalid_request"}400grant_type 이 없음
{"error": "unsupported_grant_type"}400grant_type 이 client_credentials 가 아님
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.