메인 콘텐츠로 건너뛰기

​
엔드포인트

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"
  }
}

​
유효하지 않은 키

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

​
응답 필드

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