메인 콘텐츠로 건너뛰기

​
엔드포인트

GET /v1/validation

​
개요

API 키가 정상인지, 만료/폐기되었는지 확인합니다. 키 타입에 관계없이 사용할 수 있는 공통 엔드포인트입니다. SDK/앱 초기화 시 이 엔드포인트로 키 유효성을 먼저 확인하는 것을 권장합니다.

​
요청

curl https://api.ones1ght.com/v1/validation \
  -H "Authorization: Bearer $API_KEY"

​
응답

​
정상 키

{
  "success": true,
  "data": {
    "status": "active",
    "key_type": "client_sdk",
    "key_prefix": "osk_two_708f",
    "tenant_code": "two",
    "created_at": "2026-04-17T05:36:28.123Z",
    "expires_at": "2026-06-16T05:36:28.123Z"
  }
}

​
만료된 키

{
  "success": true,
  "data": {
    "status": "expired",
    "key_type": "client_sdk",
    "key_prefix": "osk_two_708f",
    "tenant_code": "two",
    "created_at": "2026-01-01T00:00:00Z",
    "expires_at": "2026-03-01T00:00:00Z"
  }
}

​
유효하지 않은 키

키가 존재하지 않거나 잘못된 경우 OpenApiKeyFilter에서 401이 반환됩니다: 
{
  "success": false,
  "message": "Invalid or expired API key"
}

​
응답 필드

필드설명
status키 상태: active, expired, revoked
key_type키 타입: client_sdk 또는 rest_api
key_prefix키 앞 12자 (식별용)
tenant_code테넌트 코드
created_at키 생성 시각
expires_at만료 예정 시각 (null이면 영구)