All Products
Search
Document Center

AI Coding Assistant Lingma:Kueri informasi pengguna secara batch

Last Updated:Mar 27, 2026

Menanyakan informasi beberapa pengguna berdasarkan id pengguna atau username.

Edisi yang didukung

Enterprise Dedicated Edition

Titik akhir layanan

Dapatkan titik akhir layanan dan ganti {domain} dalam sintaks permintaan API dengan endpoint Anda.

Informasi otorisasi

Produk

Resource

Izin yang diperlukan

Organization Management

User

Hanya baca

Sintaks permintaan

POST https://{domain}/oapi/v1/platform/users:batchRead

Permintaan

Berdasarkan userIds

curl -X 'POST' \
  'https://test-domain-***.rdc.aliyuncs.com/oapi/v1/platform/users:batchRead' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --data '
    {
        "userIds": ["99d1****6124"]
    }'

Berdasarkan usernames

curl -X 'POST' \
  'https://test-domain-***.rdc.aliyuncs.com/oapi/v1/platform/users:batchRead' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484' \
  --data '
    {
        "usernames": ["testUsername"]
    }'

Header permintaan

x-yunxiao-token string (Wajib)

Token akses. Lihat Access token untuk detailnya.

Contoh: pt-0fh3****0fbG_35af****0484.

Parameter permintaan

userIds array[string](Opsional)

Daftar ID pengguna. Anda harus menentukan salah satu dari userIds atau usernames, tetapi tidak keduanya.

usernames array[string](Opsional)

Daftar username. Anda harus menentukan salah satu dari userIds atau usernames, tetapi tidak keduanya.

Parameter respons

Contoh respons

[
    {
        "email": "test****@example.com",
        "id": "99d1****6124",
        "lastOrganization": "99d1****6124",
        "name": "Example User Name",
        "staffId": "123****",
        "sysDeptIds": ["99d1****6124"],
        "username": "demo**username",
        "createdAt": "2025-01-20T10:25:56Z"
    }
]

email string

Alamat email pengguna.

createdAt string

Waktu akun dibuat.

id string

ID pengguna.

lastOrganization string

ID organisasi yang terakhir diakses oleh pengguna.

name string

Nama tampilan pengguna.

staffId string

ID karyawan.

sysDeptIds array[string]

ID departemen tempat pengguna tersebut terdaftar.

username string

Nama login pengguna.

Kode error

Untuk informasi lebih lanjut, lihat Error codes.