공개 API

401, 403, 422, 429 가려내기

401은 키가 아예 받아들여지지 않았다는 뜻입니다. 403은 키는 통했지만 그 동작이 허용되지 않는다는 뜻입니다. 422는 요청은 이해되었고 본문이 잘못됐다는 뜻입니다. 429는 속도 한도를 넘었으니 곧바로 다시 시도하지 말고 기다리라는 뜻입니다.

최종 검토 2026년 8월 20일

절차

1. 401에서는 키가 있는지, 만료되지 않았는지, 생각하는 헤더로 보내지는지 확인합니다. 흔한 원인은 잘려 붙은 값입니다.
2. 403에서는 code를 읽습니다. 스코프 부족, 허용 목록 밖 주소, 또는 다른 워크스페이스의 키입니다. 다시 연결해도 소용없고, 바뀌어야 할 것은 권한입니다.
3. 422에서는 응답이 지목한 필드를 읽고 본문을 고칩니다.
4. 429에서는 속도 한도 헤더를 존중하고 기다립니다. 곧바로 다시 보내면 더 나빠집니다.
5. 응답의 requestId를 남겨 두세요. 지원팀이 바로 그 호출을 찾을 수 있게 하는 것이 그것입니다.

결과 확인 방법

고친 뒤 같은 요청이 성공하고, 응답이 2xx 상태와 기대한 객체를 담고 있습니다.

흔히 어긋나는 지점

• 403을 키 불량으로 여겨 다시 발급하는 것. 아무것도 달라지지 않습니다.
• 429를 촘촘한 반복으로 계속 두드리는 것.
• 지원팀에 요청 ID가 아니라 키를 보내는 것.