DESTINYAPI · Developer Portal

인증

Destiny Engine API는 API 키 기반 인증을 사용합니다. 모든 API 요청에는 유효한 API 키가 필요하며, HTTP 헤더에 포함하여 전송해야 합니다.

API 키 발급

API 키를 발급받으려면 다음 단계를 따르세요:

  1. 개발자 포털에 로그인합니다 (계정이 없다면 회원가입을 진행하세요).
  2. API 키 관리 페이지로 이동합니다.
  3. "새 API 키 생성" 버튼을 클릭합니다.
  4. 생성된 API 키를 안전한 곳에 저장합니다 (한 번만 표시되며 다시 확인할 수 없습니다).

보안 주의사항

API 키는 비밀번호처럼 취급해야 합니다. 절대 공개 저장소나 클라이언트 측 코드에 하드코딩하지 마세요. 환경 변수나 비밀 관리 시스템을 사용하는 것을 권장합니다.

API 키 사용하기

모든 API 요청에는 X-API-Key 헤더에 API 키를 포함해야 합니다:

# API 키를 헤더에 포함
curl -X GET https://api.destinyapi.com/health \
  -H "X-API-Key: your_api_key_here"

API 사용 등급

Destiny Engine API는 다음과 같은 사용 등급을 제공합니다:

Free

무료

  • ✓ 가입 시 500 크레딧 (일회성)
  • ✓ 모든 기본 엔드포인트
  • ✓ 커뮤니티 지원

Developer

₩39,000/월

  • ✓ 월 30,000 크레딧
  • ✓ 샌드박스 5,000 크레딧
  • ✓ 모든 엔드포인트
  • ✓ 이메일 지원

Professional

₩149,000/월

  • ✓ 월 150,000 크레딧
  • ✓ 샌드박스 30,000 크레딧
  • ✓ AI 기반 분석 포함
  • ✓ 프리미엄 지원

엔터프라이즈 문의

대규모 크레딧, 전용 서버, 팀 온보딩이 필요하다면 sales@destinyapi.com으로 연락해 맞춤 견적을 받아보세요.

요청 제한 (Rate Limiting)

각 API 키는 등급에 따라 일일 요청 제한이 있습니다. 제한을 초과하면 429 Too Many Requests 에러가 반환됩니다.

응답 헤더에서 현재 사용량을 확인할 수 있습니다:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1640995200

에러 처리

인증 관련 일반적인 에러 응답:

상태 코드설명
401API 키가 누락되었거나 유효하지 않음
403API 키가 비활성화되었거나 해당 리소스에 접근 권한이 없음
429요청 제한 초과

다음 단계

이제 API 키를 발급받았으니, 첫 번째 API 요청을 보내보세요:

첫 번째 요청 보내기 →