Device Management/Device List Management/Organization Device List

Query Organization Device O&M List

Paginated query of device O&M details in organization by device type (Required, e.g. Aircraft/Dock/Communication Device/Battery, etc.); supports filtering by model primary key, online status, firmware upgrade status, workspace project, join time range, SN slice, and other multi-dimensional conditions; returns rich device O&M info (online status, firmware version, work status, associated devices, dock offline location, etc.). Frontend's "Device O&M Management" main table uses this API.

Call Conditions: caller must be organization administrator/super administrator or Device Maintainer. Device Maintainers can only see devices in projects they are authorized for.

Pagination Characteristics: Only paginated by database when device_model_class=drone; other types return full data (page=1, page_size equals total). list[] field set varies by device type (drone / airport / communication / drone-battery / payload); common fields include device_sn / device_callsign / device_model / device_add_time / device_code / device_last_online_time.

get/openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices

Request

  • Base URL
    https://41b04hdzmc.apifox.cn (the document declares no server; this is the origin it was published from)
  • URL
    https://41b04hdzmc.apifox.cn/openapi/v2.0/manage/api/v1/organizations/{uuid}/manage-devices
  • Auth
    none required

Path parameters

uuidstring required

Organization UUID

Query parameters

device_model_class'drone' | 'airport' | 'communication' | 'base_station' required

Device Type; Required; supports repeated parameters for multi-select, e.g. device_model_class=drone&device_model_class=airport

device_model_keystring[]

Model Primary Key; supports repeated parameters; precise filter for specific models, e.g. 0-67-0

device_online_status'online' | 'offline'

Device Online Status Filter. online: Online; offline: Offline

device_working_statusnumber

Device Working Status Filter; effective only for Dock/communication devices

firmware_statusinteger[]

Firmware Status Filter; supports repeated parameters

flysafe_database_upgrade_statusinteger[]

Flight Safety Database Status Filter; 1=No Upgrade Needed / 2=Upgrade Pending / 3=Upgrading; supports repeated parameters

device_snstring[]

Specified SN Slice Query (O&M Targeted Query); supports repeated parameters; when provided, ignores other filters and returns by these SNs directly

active_projectstring[]

Workspace Project UUID Filter; supports repeated parameters; pass empty string to match devices without workspace project

join_time_startinteger

Organization Join Start Time (Second-Level Unix Timestamp)

join_time_endinteger

Organization Join End Time (Second-Level Unix Timestamp)

pageinteger

Page Number, starting from 1; default 1. Only paginated by DB when device_model_class=drone; other types return full data

page_sizeinteger

Items Per Page; Same as Above

qstring

Keyword Fuzzy Search

sort_columnstring

Sort Field

sort_type'ASC' | 'DESC'

Sort Direction. ASC: Ascending; DESC: Descending

Headers

x-user-tokenstring required

User Login Token

X-Request-Idstring

Request Trace ID, Optional

X-Project-Uuidstring required

Project UUID

Response

Success

codeinteger required

Business Status Code: 0=Success; non-zero=Error Code (see message for meaning)

messagestring

Error Description Message (Omitted on Success)

Changes

No recorded changes to this operation across all 1 revision of this API.