查詢訂閱席位明細

前提條件

已取得阿里雲帳號或 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/subscription/seat-detail
驗證方式 此 API 為阿里雲 OpenAPI，採用 AccessKey 簽名（簽名演算法 ACS3-HMAC-SHA256），不支援 Authorization: Bearer {API_KEY} 方式。請求需攜帶公用請求標頭 x-acs-action: GetSubscriptionSeatDetails、x-acs-version: 2026-02-10、x-acs-date、x-acs-content-sha256、x-acs-signature-nonce 以及 Authorization。建議使用阿里雲 SDK 或 OpenAPI Explorer 發起呼叫，可免去自行計算簽名。

地域	Endpoint
新加坡	`GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail`

請求參數

所有參數均透過 Query String 傳遞。陣列類型參數（StatusList）使用 Flat 格式：以 参数名.序号 逐個傳遞，序號從 1 開始，例如 StatusList.1=NORMAL、StatusList.2=<第二个取值>。

參數	類型	必選	描述
PageNo	integer	否	分頁頁碼。預設值：1 取值範圍：正整數。
PageSize	integer	否	分頁參數：每頁顯示筆數，預設值 10。
StatusList	Array	否	席位狀態篩選清單
SeatId	string	否	席位 ID
SeatType	string	否	席位類型（specType） standard - 標準席位 pro - 進階席位 max - 尊享席位
QueryAssigned	boolean	否	席位分配狀態篩選條件。true=已分配，false=未分配，null=全部

返回參數

參數	類型	描述
Success	boolean	呼叫介面是否成功： true：成功 false：失敗
Code	string	回應狀態碼。
Message	string	回應訊息。
Data	object	業務資料
Items	Array[Object]	資料項目
	Array[Object]	資料項目
InstanceCode	string	席位 instance code
EquityList	Array[Object]	目前生效的權益執行個體，對 TokenPlan 產品而言，此清單只會有一個生效的權益執行個體
	object
EquityType	string	權益類型（如 CREDITS、SPN、資源套件等）
CycleInstanceId	string	權益 code（訂閱 code，credits 情境下不需要消費）
CycleStartTime	integer	目前週期開始時間，毫秒
CycleEndTime	integer	目前週期結束時間，毫秒
CycleTotalValue	number	目前週期的總額度
CycleSurplusValue	number	目前週期的剩餘額度
CycleVersion	integer	目前週期的時序版本
EndTime	integer	席位過期時間
SeatId	string	席位 ID
SpecType	string	席位類型 standard - 標準席位 pro - 進階席位 max - 尊享席位
StartTime	integer	席位開始時間
AssignedStatus	string	分配狀態 ASSIGNED UNASSIGNED
AccountId	string	綁定的成員帳號 ID
AccountName	string	成員帳號名稱
AccountEmail	string	成員帳號電子郵件
Status	string	席位狀態： CREATING —— 建立中 NORMAL —— 有效狀態 LIMIT ——欠費受限 RELEASE —— 到期釋放 STOP —— 到期停機 REFUNDED —— 已退款
Total	integer	席位總數量
PageNo	integer	頁碼，取值大於 0 且不超過 Integer 資料類型的最大值
PageSize	integer	每頁筆數。

請求範例

本介面使用阿里雲 OpenAPI 簽章，下例中 ${SIGNATURE} 需按 ACS3-HMAC-SHA256 演算法計算得出，x-acs-date、x-acs-signature-nonce 需替換為實際值。

curl -X GET "https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail?PageNo=1&PageSize=10&StatusList.1=NORMAL&SeatId=seat-123456&SeatType=standard&QueryAssigned=true" \
    --header "x-acs-action: GetSubscriptionSeatDetails" \
    --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": {
    "Items": [
      {
        "InstanceCode": "subs-1234567",
        "EquityList": [
          {
            "EquityType": "CREDITS",
            "CycleInstanceId": "123456",
            "CycleStartTime": 1788328800000,
            "CycleEndTime": 1790920800000,
            "CycleTotalValue": 100,
            "CycleSurplusValue": 40,
            "CycleVersion": 1
          }
        ],
        "EndTime": 1790920800000,
        "SeatId": "seat_123456",
        "SpecType": "standard",
        "StartTime": 1788328800000,
        "AssignedStatus": "ASSIGNED",
        "AccountId": "acc_123456789",
        "AccountName": "ExampleName",
        "AccountEmail": "test@email.com",
        "Status": "NORMAL"
      }
    ],
    "Total": 100,
    "PageNo": 1,
    "PageSize": 10
  }
}

錯誤碼

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

​前提條件

​請求說明

​請求參數

​返回參數

​請求範例

​返回範例

​錯誤碼