Skip to main content

メンバー招待リンクの取得

TokenPlan メンバー招待リンクを取得します。

前提条件

Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey を取得しており、その ID にこの操作を呼び出すために必要な RAM 権限が付与されていること。AccessKey をハードコーディングするのではなく、環境変数 ALIBABA_CLOUD_ACCESS_KEY_ID および ALIBABA_CLOUD_ACCESS_KEY_SECRET として設定することを推奨します。

リクエストの説明

  • HTTPメソッド:GET
  • リクエスト URL

    リージョン

    エンドポイント

    シンガポール

    GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/get

  • 認証 この操作は、AccessKey ベースの署名(ACS3-HMAC-SHA256 アルゴリズム)を使用する Alibaba Cloud OpenAPI 操作です。Authorization: Bearer {API_KEY} スキームはサポートされていません。リクエストには共通ヘッダー x-acs-action: GetTokenPlanInviteLink、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce、および Authorization を含める必要があります。 署名を自分で計算する必要がないよう、Alibaba Cloud SDK または OpenAPI Explorer を使用してこの操作を呼び出すことを推奨します。
この操作は生成されたトークンとその有効期限のみを返します。招待リンクはhttps://{host}/accept-invite?token=[token].&orgId=[orgId]
という形式で組み立てられます。中国サイトの場合、ホストはtokenplan-enterprise.bailian.aliyunportal.comです。
国際サイトの場合、ホストはtokenplan-enterprise.modelstudio.aliyunportal.comです。

リクエストパラメーター

このAPIにはリクエストパラメータはありません。

レスポンスパラメーター

パラメーター

タイプ

説明

Success

boolean

API呼び出しが成功したかどうか:
true:成功
false:失敗

Code

string

レスポンスステータスコード。

Message

string

レスポンスメッセージ。

Data

object

レスポンスデータ

Token

string

生成された Token。

ExpireTime

integer

有効期限(単位:ミリ秒)

リクエスト例

この操作では Alibaba Cloud OpenAPI の署名を使用します。以下の例では、${SIGNATURE} を ACS3-HMAC-SHA256 アルゴリズムで計算する必要があり、x-acs-date および x-acs-signature-nonce を実際の値に置き換える必要があります。
curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/get" \
    --header "x-acs-action: GetTokenPlanInviteLink" \
    --header "x-acs-version: 2026-02-10" \
    --header "x-acs-date: 2026-01-01T12:00:00Z" \
    --header "x-acs-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855" \
    --header "x-acs-signature-nonce: ${SIGNATURE_NONCE}" \
    --header "Authorization: ACS3-HMAC-SHA256 Credential=${ALIBABA_CLOUD_ACCESS_KEY_ID},SignedHeaders=host;x-acs-action;x-acs-content-sha256;x-acs-date;x-acs-signature-nonce;x-acs-version,Signature=${SIGNATURE}"

レスポンス例

{
  "Success": true,
  "Data": {
    "Token": "sk-ws-D.****.*******",
    "ExpireTime": 1778379206
  }
}

エラーコード

呼び出しに失敗した場合、エラーメッセージが返されます。その他のエラーコードと解決策については、エラーコードを参照してください。