全部产品
Search
文档中心

AI Coding Assistant Lingma:ListDepartments

更新时间:Jul 06, 2025

Gunakan API ini untuk mengambil daftar departemen organisasi.

Edisi yang didukung

Enterprise Dedicated Edition

Titik akhir layanan

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

Informasi otorisasi

Produk

Sumber daya

Izin yang diperlukan

Manajemen Organisasi

Departemen organisasi

Hanya-baca

Sintaks permintaan

GET https://{domain}/oapi/v1/platform/organizations/{organizationId}/departments

Deskripsi permintaan

Mengambil daftar departemen organisasi

curl -X 'GET' \
  'https://test-domain-***.rdc.aliyuncs.com/oapi/v1/platform/organizations/9a2b****5ef1/departments' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

Mengambil semua subdepartemen di bawah departemen tertentu

curl -X 'GET' \
  'https://test-domain-***.rdc.aliyuncs.com/oapi/v1/platform/organizations/9a2b****5ef1/departments?parentId=99d1****71d4&page=1&perPage=100' \
  -H 'Content-Type: application/json' \
  -H 'x-yunxiao-token: pt-0fh3****0fbG_35af****0484'

Header permintaan (Headers)

x-yunxiao-token string (Diperlukan)

Token akses. Lihat Access Token untuk detail lebih lanjut.

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

Parameter permintaan

organizationId string (Diperlukan)

ID organisasi. Anda dapat pergi ke halaman System Management di konsol Manajemen Organisasi untuk memperoleh ID organisasi (organizationId).

parentId string (Opsional)

ID departemen induk.

page integer (Opsional) Nilai default: 1

Halaman saat ini.

perPage integer (Opsional) Nilai default: 100

Jumlah entri per halaman. Nilai valid: [1, 100].

Parameter respons

Contoh respons

[
    {
        "creatorId": "99d1****6124",
        "hasSub": true,
        "id": "99d1****6124",
        "name": "Contoh",
        "organizationId": "99d1****6124",
        "parentId": "99d1****6124"
    }
]

creatorId string

ID pembuat.

hasSub boolean

Menunjukkan apakah departemen memiliki subdepartemen.

id string

ID departemen.

name string

Nama departemen.

organizationId string

ID organisasi.

parentId string

ID departemen induk.

Header respons

Parameter

Deskripsi

Nilai contoh

x-next-page

Halaman berikutnya.

1

x-page

Halaman saat ini.

2

x-per-page

Jumlah entri per halaman.

1

x-prev-page

Halaman sebelumnya.

2

x-total

Jumlah total entri.

1

x-total-pages

Jumlah total halaman.

10

Kode kesalahan

Untuk informasi lebih lanjut, lihat Kode Kesalahan.