コンテンツにスキップ

当前のワークスペーストークンのローテーション



POST /api/v1/workspace/token/rotate

概要

現在のAPIキーが属するワークスペースのトークンをローテーションし、新しいトークンを返します。

説明:

  • 本APIはワークスペース属性の token のみを操作し、cliToken は対象外です。
  • 一括処理はサポートしていません。
  • ttl は古いトークンの遅延失効時間です。呼び出し側でカスタム設定可能です。

Body リクエストパラメータ

パラメータ名 タイプ 必須 説明
ttl string はい 旧トークンの残存有効期間。カスタム期間文字列を指定可能。最大1日。
例: 24h
空を許可: いいえ
$matchRegExp: ^(0s|[1-9][0-9]*[smhd])$

パラメータ補足説明

(原文空のため空欄)

リクエスト例

curl 'https://openapi.guance.com/api/v1/workspace/token/rotate' \
-H 'DF-API-KEY: <DF-API-KEY>' \
-H 'Content-Type: application/json;charset=UTF-8' \
--data-raw '{"ttl":"24h"}' \
--compressed

レスポンス

{
    "code": 200,
    "content": {
        "token": "tkn_xxxxx",
        "openDataQuery": true
    },
    "errorCode": "",
    "message": "",
    "success": true,
    "traceId": "TRACE-2956247345653191101"
}

フィードバック

このページは役に立ちましたか?