API 인증 — JWT 토큰 // API

API 인증 — JWT 토큰

OODA Intelligence API는 모든 요청에 JWT(JSON Web Token) 인증을 사용합니다.

토큰 발급받기

인증 엔드포인트로 POST 요청을 보냅니다.

curl -X POST https://dashboard.oodaintel.com/api/v1/auth/token/ \
  -H "Content-Type: application/json" \
  -d '{"username": "사용자명", "password": "비밀번호"}'

응답

{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

토큰 사용하기

발급받은 액세스 토큰을 모든 요청의 Authorization 헤더에 넣습니다.

curl -X GET https://dashboard.oodaintel.com/api/v1/monitoring/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."

토큰 갱신하기

액세스 토큰이 만료되면 리프레시 토큰으로 새 토큰을 받습니다.

curl -X POST https://dashboard.oodaintel.com/api/v1/auth/token/refresh/ \
  -H "Content-Type: application/json" \
  -d '{"refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."}'

요청 한도(Rate Limiting)

요청 한도는 계약한 요금제에 따라 달라집니다.

요금제 한도
Starter 100 req/min
Professional 500 req/min
Enterprise 2,000 req/min

자주 발생하는 오류

코드 설명
401 토큰이 유효하지 않거나 만료됨
403 해당 리소스에 대한 권한 없음
429 요청 한도 초과