API 키 보안

API 키 준비

아바타의 Settings에서 개인 센터 API Key를 엽니다. 계정당 유효 키 하나이며 재생성하면 기존 키는 즉시 무효, 전체 값은 한 번만 표시됩니다. 모든 요청에 X-API-Key, POST에 Content-Type: application/json을 보냅니다. 웹 JWT, Cookie, Device-ID, hash, platform은 필요 없으며 Bearer로 대체할 수 없습니다.

API 키 보안

키는 서버 환경 변수나 비밀 저장소에만 보관하며 프런트엔드, 공개 저장소나 클라이언트에 넣지 마세요. URL, 본문, 로그나 문의에 쓰지 않습니다. 예제는 API_KEY를 사용합니다. 유출 시 즉시 재생성/비활성화하고 모든 호출자를 갱신합니다.

오류 및 재시도

400은 인수 수정, 401/403은 키/계정, 409는 충돌 해소, 429는 백오프합니다. 조회는 한도 내 재시도 가능. 쓰기에는 공개 멱등 키가 없어 timeout/500 후 먼저 수락 상태를 확인합니다. 앱 없음, 버전 불일치나 제출 실패도 500 / PUBLIC_API_INTERNAL_ERROR일 수 있어 미실행 증거가 아닙니다.

검증 및 지원

문의에는 request_id, 경로, HTTP, reason, 시간과 가린 인수를 주고 키는 보내지 마세요. 조회부터 검증한 뒤 허가된 테스트 기기에서 쓰기를 수행하고 결과 확인 후 규모를 늘립니다.

관련 문서

• Public API 사용 안내
• 문제 해결 및 지원