メインコンテンツへスキップ

​
エンドポイント

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

​
無効なキー

キーが存在しないか不正な場合、認証フィルターから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の場合は無期限）