Skip to main content

建立席位(新購)

建立一個或多個 Token Plan 團隊版席位。

前提條件

已取得阿里雲帳號或 RAM 使用者的 AccessKey,並已為其授予呼叫 BssOpenApi 所需的 RAM 權限。建議將 AccessKey 設定為環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID 和 ALIBABA_CLOUD_ACCESS_KEY_SECRET,避免以明文寫入程式碼。 已透過 QueryProductList 取得 ProductCode、ProductType 和 SubscriptionType。Token Plan 團隊版的範例取值為 sfm、sfm_tokenplanteams_dp_intl 和 Subscription。

請求說明

  • HTTP 方法:POST
  • 請求 URL

    地域

    Endpoint

    新加坡

    POST https://business.ap-southeast-1.aliyuncs.com/

  • 認證方式 本介面屬於 BssOpenApi(版本 2023-09-30),採用 AccessKey 簽名(RPC 簽名,HMAC-SHA1),不支援 Authorization: Bearer {API_KEY} 方式。推薦使用阿里雲 SDK 的 CommonRequest 發起呼叫,SDK 會自動產生公共參數並計算簽名。

請求參數

全部參數透過表單或 Query String 傳遞。陣列參數使用 Flat 格式:Configs.1.Code、Configs.1.Value,序號從 1 開始。

參數

類型

必選

描述

ProductCode

string

是

產品代碼。透過 QueryProductList 取得,例如 sfm。

ProductType

string

是

產品類型。透過 QueryProductList 取得,例如 sfm_tokenplanteams_dp_intl。

SubscriptionType

string

是

訂閱類型。透過 QueryProductList 取得,例如 Subscription。

ClientToken

string

是

冪等性權杖。由客戶端產生,需保證不同請求間唯一,最大 64 個 ASCII 字元。

Period

integer

是

付費週期數,至少為 1。

PeriodUnit

string

是

付費週期單位。取值:Year(年)、Month(月)。

AutoRenew

boolean

否

是否開啟自動續費。

SubscriptionConfigs

Array

是

訂閱規格列表,支援一次建立多種規格。

SubscriptionConfigs.N.Seats

long

是

席位數量,至少為 1。

SubscriptionConfigs.N.Configs

Array

是

模組屬性列表。

SubscriptionConfigs.N.Configs.N.Code

string

否

模組屬性 code,例如 plan_type。

SubscriptionConfigs.N.Configs.N.Value

string

否

模組屬性 value,例如 standard、pro、max。

Configs 中的 Code 和 Value 需成對填寫,取值以商品支援的屬性為準。

返回參數

參數

類型

描述

RequestId

string

請求 ID。

Success

boolean

是否成功。

Code

string

結果碼,成功為 Success。

Message

string

結果描述。

Data

object

業務資料。

Data.OrderId

long

訂單 ID。

Data.InstanceId

Array[string]

執行個體 ID 列表。

Data.HostId

string

站點識別碼。部分回應可能不返回該欄位。

AccessDeniedDetail

string

RAM 權限被拒絕時的詳細錯誤訊息。

請求範例

本介面使用 BssOpenApi 的 RPC 簽名。下例中 ${SIGNATURE} 需按簽名演算法計算,SignatureNonce 和 Timestamp 需替換為實際值。使用阿里雲 SDK 時會自動處理公共參數和簽名。
curl -X POST "https://business.ap-southeast-1.aliyuncs.com/" \
    --data-urlencode "Action=CreateCreditSeat" \
    --data-urlencode "Version=2023-09-30" \
    --data-urlencode "Format=JSON" \
    --data-urlencode "AccessKeyId=${ALIBABA_CLOUD_ACCESS_KEY_ID}" \
    --data-urlencode "SignatureMethod=HMAC-SHA1" \
    --data-urlencode "SignatureVersion=1.0" \
    --data-urlencode "SignatureNonce=${SIGNATURE_NONCE}" \
    --data-urlencode "Timestamp=2026-01-01T12:00:00Z" \
    --data-urlencode "Signature=${SIGNATURE}" \
    --data-urlencode "ProductCode=sfm" \
    --data-urlencode "ProductType=sfm_tokenplanteams_dp_intl" \
    --data-urlencode "SubscriptionType=Subscription" \
    --data-urlencode "ClientToken=example-client-token-001" \
    --data-urlencode "Period=1" \
    --data-urlencode "PeriodUnit=Month" \
    --data-urlencode "AutoRenew=false" \
    --data-urlencode "SubscriptionConfigs.1.Seats=1" \
    --data-urlencode "SubscriptionConfigs.1.Configs.1.Code=plan_type" \
    --data-urlencode "SubscriptionConfigs.1.Configs.1.Value=standard"

返回範例

{
  "RequestId": "request-id-example",
  "Success": true,
  "Code": "Success",
  "Message": "Successful!",
  "Data": {
    "OrderId": 1234567890123456,
    "InstanceId": [
      "subs-example0000000001"
    ]
  }
}

錯誤碼

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