Skip to main content

取得成員邀請連結

取得 TokenPlan 成員邀請連結

前提條件

已取得阿里雲帳號或 RAM 使用者的 AccessKey,並已為其授予呼叫此 API 所需的 RAM 權限。建議將 AccessKey 設定為環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET,避免以明文寫入程式碼。

請求說明

  • HTTP 方法:GET
  • 請求地址

    地域

    Endpoint

    新加坡

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

  • 驗證方式 此 API 為阿里雲 OpenAPI,採用 AccessKey 簽名(簽名演算法 ACS3-HMAC-SHA256),不支援 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。 建議使用阿里雲 SDK 或 OpenAPI Explorer 發起呼叫,可免去自行計算簽名。
該介面只回傳產生的 token 和過期時間,邀請連結的拼接格式為 https://{host}/accept-invite?token=[token]&orgId=[orgId]
國內站 host 為 tokenplan-enterprise.bailian.aliyunportal.com
國際站 host 為 tokenplan-enterprise.modelstudio.aliyunportal.com

請求參數

此介面無請求參數。

返回參數

參數

類型

描述

Success

boolean

呼叫介面是否成功:
true:成功
false:失敗

Code

string

回應狀態碼。

Message

string

回應訊息。

Data

object

回傳資料

Token

string

產生 Token。

ExpireTime

integer

過期時間(單位:毫秒)

請求範例

本介面使用阿里雲 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: 3e3b2a9f0c7d4f8e9a1b2c3d4e5f6a7b" \
    --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
  }
}

錯誤碼

如果呼叫失敗,會返回錯誤訊息。更多錯誤碼及解決方法,請參閱錯誤訊息。