인증

API 키를 사용한 안전한 인증

인증 방식

USDTLowFee API는 API 키 인증을 사용합니다. 모든 요청에는 HTTP 헤더에 유효한 API 키가 포함되어야 합니다.

요청 형식

모든 요청에는 인증 헤더가 포함되어야 합니다:

Authorization: ApiKey ak_live_YOUR_API_KEY

API 키 생성

  1. 콘솔에 로그인하고 계정 설정으로 이동합니다
  2. "API 키" 탭을 클릭합니다
  3. "API 키 생성"을 클릭합니다
  4. 설명이 포함된 이름을 입력합니다 (예: Production, Test)
  5. 생성된 API 키를 저장합니다 (한 번만 표시됨)

⚠️ 보안 규칙 (필독)

  1. API 키를 비밀번호처럼 취급하세요: 한 번만 표시되며, 분실 시 새로 생성해야 합니다
  2. 프론트엔드 코드/저장소에 절대 넣지 마세요: 서버측 환경 변수 또는 Secret Manager에만 보관하세요
  3. URL/쿼리스트링에 절대 넣지 마세요 (로그/프록시 유출 방지): Authorization 헤더에만 사용하세요
  4. 유출이 의심되는 경우 즉시 폐기하고 새 키를 생성하세요

API 키 폐기

API 키가 유출되었거나 더 이상 필요하지 않은 경우:

  1. 계정 설정 → API 키로 이동합니다
  2. 폐기할 키를 찾습니다
  3. "폐기" 버튼을 클릭합니다
  4. 작업을 확인합니다

⚠️ 폐기 후 해당 API 키를 사용하는 모든 요청은 즉시 실패합니다

API 키 교체

권장 교체 프로세스:

  1. 새 API 키를 생성합니다
  2. 애플리케이션에서 점진적으로 새 키로 전환합니다
  3. 새 키가 정상 작동하는지 확인한 후
  4. 이전 API 키를 폐기합니다

일반적인 인증 오류

Unauthorized

401

API 키가 유효하지 않거나, 만료되었거나, 폐기되었습니다

해결책: API 키가 올바른지 확인하거나 새 API 키를 생성하세요

Forbidden

403

계정 잔액 또는 권한이 부족합니다

해결책: 계정 잔액을 충전하거나 계정 상태를 확인하세요