Mendapatkan Detail Kursi Langganan - Alibaba Cloud Model Studio

Prasyarat

Anda telah memperoleh AccessKey dari akun Alibaba Cloud atau pengguna RAM, dan identitas tersebut telah diberikan izin RAM yang diperlukan untuk memanggil operasi ini. Kami menyarankan Anda menetapkan AccessKey sebagai variabel lingkungan ALIBABA_CLOUD_ACCESS_KEY_ID dan ALIBABA_CLOUD_ACCESS_KEY_SECRET alih-alih meng-hardcode-nya.

Deskripsi permintaan

Metode HTTP: GET
URL Permintaan
Wilayah
Endpoint
Singapura
GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail
Autentikasi Operasi ini adalah operasi Alibaba Cloud OpenAPI yang menggunakan tanda tangan berbasis AccessKey (algoritma ACS3-HMAC-SHA256). Skema Authorization: Bearer {API_KEY} tidak didukung. Permintaan harus menyertakan header umum x-acs-action: GetSubscriptionSeatDetails, x-acs-version: 2026-02-10, x-acs-date, x-acs-content-sha256, x-acs-signature-nonce, dan Authorization. Kami menyarankan Anda memanggil operasi ini dengan Alibaba Cloud SDK atau OpenAPI Explorer sehingga Anda tidak perlu menghitung tanda tangan sendiri.

Wilayah	Endpoint
Singapura	`GET https://modelstudio.ap-southeast-1.aliyuncs.com/tokenplan/subscription/seat-detail`

Parameter permintaan

Semua parameter diteruskan dalam query string. Parameter array (StatusList) menggunakan format Flat: teruskan setiap elemen sebagai ParameterName.N, di mana N dimulai dari 1. Contohnya, StatusList.1=NORMAL dan StatusList.2=<second value>.

Parameter	Tipe	Wajib	Deskripsi
PageNo	integer	Tidak	Nomor halaman paginasi. Nilai default: 1 Rentang nilai: bilangan bulat positif.
PageSize	integer	Tidak	Parameter paginasi: jumlah item yang ditampilkan per halaman, nilai default 10.
StatusList	Array	Tidak	Daftar filter status seat
SeatId	string	Tidak	id seat
SeatType	string	Tidak	Jenis kursi (specType) standard - Kursi Standard pro - Kursi Pro max - Kursi Max
QueryAssigned	boolean	Tidak	Filter status penugasan kursi. true=Ditugaskan, false=Belum ditugaskan, null=Semua

Parameter respons

Parameter	Tipe	Deskripsi
Success	boolean	Apakah panggilan API berhasil: true: berhasil false: gagal
Code	string	Kode status respons.
Message	string	Pesan respons.
Data	object	Data bisnis.
Items	Array[Object]	Item data
	Array[Object]	Item data
InstanceCode	string	kode instance seat
EquityList	Array[Object]	Instans hak yang sedang berlaku, untuk produk TokenPlan, daftar ini hanya akan memiliki satu instans hak yang berlaku
	object
EquityType	string	Jenis hak (seperti CREDITS, SPN, paket sumber daya, dll.)
CycleInstanceId	string	Kode hak (kode langganan, tidak perlu dikonsumsi dalam skenario credits)
CycleStartTime	integer	Waktu mulai periode saat ini, dalam milidetik
CycleEndTime	integer	Waktu berakhir periode saat ini, dalam milidetik
CycleTotalValue	angka	Kuota total periode saat ini
CycleSurplusValue	angka	Sisa kuota periode saat ini
CycleVersion	integer	Versi urutan waktu periode saat ini
EndTime	integer	Waktu kedaluwarsa seat
SeatId	string	ID Seat
SpecType	string	Jenis seat. standard - Seat standar pro - Seat pro max - Seat max
StartTime	integer	Waktu mulai seat
AssignedStatus	string	Status penugasan ASSIGNED UNASSIGNED
AccountId	string	ID akun anggota yang terikat
AccountName	string	Nama akun anggota
AccountEmail	string	Email akun anggota
Status	string	Status kursi: CREATING —— Sedang dibuat NORMAL —— Status aktif LIMIT —— Terbatas karena tunggakan RELEASE —— Dirilis karena kedaluwarsa STOP —— Dihentikan karena kedaluwarsa REFUNDED —— Telah direfund
Total	integer	Jumlah total seat
PageNo	integer	Nomor halaman, nilainya lebih besar dari 0 dan tidak melebihi nilai maksimum tipe data Integer
PageSize	integer	Jumlah item per halaman.

Contoh permintaan

Operasi ini menggunakan tanda tangan Alibaba Cloud OpenAPI. Dalam contoh berikut, ${SIGNATURE} harus dihitung dengan algoritma ACS3-HMAC-SHA256, dan x-acs-date serta x-acs-signature-nonce harus diganti dengan nilai aktual.

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}"

Contoh respons

{
  "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
  }
}

Kode kesalahan

Jika pemanggilan gagal, pesan kesalahan akan dikembalikan. Untuk kode kesalahan dan solusi selengkapnya, lihat Kode kesalahan.

​Prasyarat

​Deskripsi permintaan

​Parameter permintaan

​Parameter respons

​Contoh permintaan

​Contoh respons