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

​
エンドポイント

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)