API
에러 & 부분 실패
에러 형식, 상태 코드, 부분 발행 실패의 보고 방식.
에러 형식
모든 에러는 동일한 형태를 가집니다.
{ "error": { "code": "...", "message": "..." } }상태 코드
| 상태 | 코드 | 의미 |
|---|---|---|
| 401 | UNAUTHENTICATED | API 키 누락 또는 무효 |
| 403 | BLOCKED | 차단된 계정 |
| 403 | PLAN_REQUIRED | 워크스페이스가 크리에이터 플랜 미만 |
| 404 | NOT_FOUND | 리소스 없음 |
| 422 | VALIDATION_ERROR | 요청 본문 검증 실패 |
| 429 | RATE_LIMITED | 레이트 리밋 초과 (분당 30) |
| 500+ | INTERNAL_ERROR | 예기치 못한 서버 오류 |
부분 실패
여러 계정에 발행하면 일부는 성공하고 일부는 실패할 수 있습니다. 이 경우 요청은 계정별 결과와 함께 HTTP 200을 반환합니다.
{
"results": [
{ "accountId": "...", "status": "succeeded" },
{ "accountId": "...", "status": "failed", "error": "..." }
],
"summary": { "succeeded": 1, "failed": 1 }
}모든 대상이 실패하면 대신 HTTP 502를 반환합니다.