Skip to main content

建立成員邀請連結

建立 TokenPlan 成員邀請連結

前提條件

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

請求說明

  • HTTP 方法：POST
  • 請求地址

    地域

    Endpoint

    新加坡

    POST https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/create

  • 驗證方式 此 API 為阿里雲 OpenAPI，採用 AccessKey 簽名（簽名演算法 ACS3-HMAC-SHA256），不支援 Authorization: Bearer {API_KEY} 方式。請求需攜帶公用請求標頭 x-acs-action: CreateTokenPlanInviteLink、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce 以及 Authorization。 建議使用阿里雲 SDK 或 OpenAPI Explorer 發起呼叫，可免去自行計算簽名。
使用者只允許擁有一個有效的邀請連結
若使用者已有有效的邀請連結，該介面將回傳這個連結
若需要建立新的連結，請呼叫 RevokeTokenPlanInviteLink 介面使目前的連結失效
該介面只回傳產生的 token，邀請連結的拼接格式為 https://{host}/accept-invite?token=[token]&orgId=[orgId]
國內站 host 為 tokenplan-enterprise.bailian.aliyunportal.com
國際站 host 為 tokenplan-enterprise.modelstudio.aliyunportal.com

請求參數

所有參數均透過 Query String 傳遞。

參數

類型

必選

描述

ExpireType

string

否

過期檔位，預設 DAYS_7
DAYS_7
DAYS_30
MONTHS_6
YEAR_1

SsoSource

string

是

邀請連結綁定的 SSO 登入方式：
SAML
DINGTALK

返回參數

參數

類型

描述

Success

boolean

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

Code

string

回應狀態碼。

Message

string

回應訊息。

Data

object

業務參數

Token

string

產生的 Token

請求範例

本介面使用阿里雲 OpenAPI 簽章，下例中 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 演算法計算得出，x-acs-date、x-acs-signature-nonce 需替換為實際值。 
curl -X POST "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/invite/link/create?ExpireType=DAYS_7&SsoSource=SAML" \
    --header "x-acs-action: CreateTokenPlanInviteLink" \
    --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.****.*******"
  }
}

錯誤碼

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