인증
API 키를 사용한 안전한 인증
인증 방식
USDTLowFee API는 API 키 인증을 사용합니다. 모든 요청에는 HTTP 헤더에 유효한 API 키가 포함되어야 합니다.
요청 형식
모든 요청에는 인증 헤더가 포함되어야 합니다:
Authorization: ApiKey ak_live_YOUR_API_KEY API 키 생성
- 콘솔에 로그인하고 계정 설정으로 이동합니다
- "API 키" 탭을 클릭합니다
- "API 키 생성"을 클릭합니다
- 설명이 포함된 이름을 입력합니다 (예: Production, Test)
- 생성된 API 키를 저장합니다 (한 번만 표시됨)
⚠️ 보안 규칙 (필독)
- API 키를 비밀번호처럼 취급하세요: 한 번만 표시되며, 분실 시 새로 생성해야 합니다
- 프론트엔드 코드/저장소에 절대 넣지 마세요: 서버측 환경 변수 또는 Secret Manager에만 보관하세요
- URL/쿼리스트링에 절대 넣지 마세요 (로그/프록시 유출 방지): Authorization 헤더에만 사용하세요
- 유출이 의심되는 경우 즉시 폐기하고 새 키를 생성하세요
API 키 폐기
API 키가 유출되었거나 더 이상 필요하지 않은 경우:
- 계정 설정 → API 키로 이동합니다
- 폐기할 키를 찾습니다
- "폐기" 버튼을 클릭합니다
- 작업을 확인합니다
⚠️ 폐기 후 해당 API 키를 사용하는 모든 요청은 즉시 실패합니다
API 키 교체
권장 교체 프로세스:
- 새 API 키를 생성합니다
- 애플리케이션에서 점진적으로 새 키로 전환합니다
- 새 키가 정상 작동하는지 확인한 후
- 이전 API 키를 폐기합니다
일반적인 인증 오류
Unauthorized
401API 키가 유효하지 않거나, 만료되었거나, 폐기되었습니다
해결책: API 키가 올바른지 확인하거나 새 API 키를 생성하세요
Forbidden
403계정 잔액 또는 권한이 부족합니다
해결책: 계정 잔액을 충전하거나 계정 상태를 확인하세요