API 액세스 오류 해결하기
API 키 인증 및 권한 확인 과정에서 발생한 401 및 403 응답의 원인을 진단하세요.
업데이트:
상태 코드 확인하기
401 응답은 API가 자격 증명을 허용하지 않았다는 뜻입니다. 요청에 값이 비어 있지 않은 x-api-key 헤더가 하나만 있는지 확인하고 키가 만료, 폐기 또는 비활성화되지 않았는지 확인하세요.
403 응답은 자격 증명은 확인했지만 요청을 허용하지 않았다는 뜻입니다. 키의 엔드포인트 권한, 소유자의 현재 워크스페이스 액세스, 해당 작업에서 API 키 사용을 허용하는지, 키에 IP 허용 목록이 있는지 등을 확인하세요.
x-api-key와 Authorization를 함께 보내지 마세요. 두 자격 증명이 모두 포함된 요청은 Threetone이 거부합니다.
요청 단계별로 확인하기
- 요청이
https://api.threetone.in으로 전송되고 의도한/v1/...경로를 사용하는지 확인하세요. - 비밀 저장소에 있는 정확한 값으로 키를 교체하세요. 대시보드에 표시된 마스킹된 미리 보기 값을 사용하지 마세요.
- API Keys에서 키의 만료 여부, 비활성화 상태, 권한, IP 제한을 확인하세요.
- 키가 의도한 사용자 또는 워크스페이스 서비스 계정에 속하는지 확인하세요.
- 비밀이 유출되었을 가능성이 있으면 기존 키를 계속 테스트하지 말고 폐기한 뒤 새 키를 만드세요.
오류 증거 보관하기
API 오류에는 기계가 읽을 수 있는 status, message, request_id가 포함된 detail 객체가 사용됩니다. 이는 대부분의 인증 및 권한 오류에 해당합니다. 응답 상태와 본문, X-Request-Id 헤더를 보관하세요. 지원을 요청할 때 요청 ID는 공유해도 되지만 API 키는 절대로 공유하지 마세요.