Cosmoplat

Cosmoplat Device Management API

The Device Management API from Cosmoplat — 4 operation(s) for device management.

GitHub OpenAPI

Operations 4

GET /tenant/devicesnew 分页查询设备信息 #
POST /device 创建设备 #
DELETE /device/{deviceId} 删除设备 #
GET /device/info/{deviceId} 获取设备详情 #

Documentation

📖
Documentation
https://www.cosmoplat.com/help/detail/304/1012
📖
APIReference
https://www.cosmoplat.com/help/detail/304/1038

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/cosmoplat/refs/heads/main/openapi/cosmoplat-device-management-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/cosmoplat/refs/heads/main/errors/cosmoplat-problem-types.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/cosmoplat/refs/heads/main/data-model/cosmoplat-data-model.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/cosmoplat-device-management-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

cosmoplat-device-management-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: COSMOPlat IoT Platform Open Device Management API
  version: 线上 (online)
  summary: Device, product, alarm, rule-chain, thing-model, telemetry and RPC operations for the COSMOPlat (Kaos) industrial IoT platform.
  description: "Machine-readable transcription of the COSMOPlat 物联开发平台 (IoT development platform) \"OpenApi-线上\" reference published by COSMOPlat at https://www.cosmoplat.com/help/detail/304/1038\n\nThe provider publishes this contract as an HTML reference table only — no OpenAPI, Swagger, Postman or other machine-readable artifact is served anywhere on cosmoplat.com. This document transcribes that reference so it can be read by a machine.\n\nGAPS THE PROVIDER HAS NOT PUBLISHED (deliberately left empty here rather than guessed):\n  * No base URL / server host is stated anywhere in the reference, so `servers` is omitted.\n  * No authentication scheme is documented for these operations, so `securitySchemes` is empty.\n  * No per-operation 4xx/5xx catalogue is published; the single documented failure envelope from 公共分类 › 状态码描述 is wired as the `default` response.\n"
  contact:
    name: COSMOPlat
    email: market@cosmoplat.com
    url: https://www.cosmoplat.com/help
  x-provenance:
    authored_by: API Evangelist (catalog-authored)
    method: generated
    source: https://www.cosmoplat.com/help/detail/304/1038
    generated: '2026-08-11'
    note: Transcribed field-for-field from the provider's published HTML API reference. COSMOPlat does not publish an OpenAPI document; this is not a provider artifact. Re-harvest and replace verbatim if COSMOPlat ever serves one.
tags:
- name: Device Management
paths:
  /tenant/devicesnew:
    get:
      operationId: getTenantDevicesnew
      summary: 分页查询设备信息
      tags:
      - Device Management
      parameters:
      - name: page
        in: query
        required: true
        schema:
          type: string
        description: 页数（从0开始）
      - name: pageSize
        in: query
        required: true
        schema:
          type: string
        description: 每页最大数量
      - name: productManageId
        in: query
        required: false
        schema:
          type: string
        description: 产品配置id
      - name: name
        in: query
        required: false
        schema:
          type: string
        description: 设备标识
      - name: realName
        in: query
        required: false
        schema:
          type: string
        description: 设备名称
      - name: nodeType
        in: query
        required: false
        schema:
          type: string
        description: 节点类型： DIRECT_DEVICE:直连设备，GATEWAY_DEVICE:网关设备，GATEWAY_CHILD_DEVICE:网关子设备
      - name: active
        in: query
        required: false
        schema:
          type: string
        description: 设备状态true在线false离线
      responses:
        '200':
          description: 业务数据 / Business payload
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: object
                          properties:
                            entityType:
                              type: string
                              description: 固定值：DEVICE
                            id:
                              type: string
                              description: 设备ID
                          description: 设备ID
                        createdTime:
                          type: number
                          description: 创建时间
                        tenantId:
                          type: object
                          properties:
                            entityType:
                              type: string
                              description: 固定值：TENANT
                            id:
                              type: string
                              description: 租户ID
                          description: 租户
                        name:
                          type: string
                          description: 设备标识
                        realName:
                          type: string
                          description: 设备名称
                        productManageId:
                          type: object
                          properties:
                            entityType:
                              type: string
                              description: 固定值：TB_PRODUCT_MANAGE
                            id:
                              type: string
                              description: 产品ID
                          description: 产品
                        description:
                          type: string
                          description: 描述
                        image:
                          type: string
                          description: 图片
                        active:
                          type: boolean
                          description: 设备状态true在线false离线
                        nodeType:
                          type: string
                          description: 节点类型： DIRECT_DEVICE:直连设备，GATEWAY_DEVICE:网关设备，GATEWAY_CHILD_DEVICE:网关子设备
                        credentialsType:
                          type: string
                          description: 凭据类型：ACCESS_TOKEN，X509_CERTIFICATE，MQTT_BASIC，LWM2M_CREDENTIALS
                        lastActivityTime:
                          type: number
                          description: 最近在线时间
                        deviceCredentialsId:
                          type: string
                          description: 访问令牌
                    description: 业务数据
                  totalPages:
                    type: number
                    description: 总页数
                  totalElements:
                    type: number
                    description: 总条数
                  hasNext:
                    type: boolean
                    description: 是否存在下一条记录
        default:
          description: 失败响应 / Failure envelope documented in 公共分类 › 状态码描述
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      externalDocs:
        description: 分页查询设备信息
        url: https://www.cosmoplat.com/help/detail/304/1038
  /device:
    post:
      operationId: postDevice
      summary: 创建设备
      tags:
      - Device Management
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                realName:
                  type: string
                  description: 设备名称
                productManageId:
                  type: object
                  properties:
                    id:
                      type: string
                      description: 产品ID
                    entityType:
                      type: string
                      description: 固定值：TB_PRODUCT_MANAGE
      responses:
        '200':
          description: 业务数据 / Business payload
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: object
                    properties:
                      entityType:
                        type: string
                      id:
                        type: string
                        description: 设备ID
                    description: 设备ID
                  createdTime:
                    type: number
                    description: 创建时间
                  tenantId:
                    type: object
                    properties:
                      entityType:
                        type: string
                        description: 固定值：TENANT
                      id:
                        type: string
                        description: 租户ID
                    description: 租户
                  name:
                    type: string
                    description: 设备标识
                  realName:
                    type: string
                    description: 设备名称
                  productManageId:
                    type: object
                    properties:
                      entityType:
                        type: string
                        description: 固定值：TB_PRODUCT_MANAGE
                      id:
                        type: string
                        description: 产品ID
                    description: 产品
                  description:
                    type: string
                    description: 设备描述
                  image:
                    type: string
                    description: 图片
                  active:
                    type: string
                    description: 设备状态true在线false离线
                  lat:
                    type: string
                    description: 纬度
                  lon:
                    type: string
                    description: 经度
                  address:
                    type: string
                    description: 详细地址
        default:
          description: 失败响应 / Failure envelope documented in 公共分类 › 状态码描述
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      externalDocs:
        description: 创建设备
        url: https://www.cosmoplat.com/help/detail/304/1038
  /device/{deviceId}:
    delete:
      operationId: deleteDeviceByDeviceId
      summary: 删除设备
      tags:
      - Device Management
      description: 成功httpCode返回200
      parameters:
      - name: deviceId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: 成功 / Success
        default:
          description: 失败响应 / Failure envelope documented in 公共分类 › 状态码描述
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      externalDocs:
        description: 删除设备
        url: https://www.cosmoplat.com/help/detail/304/1038
  /device/info/{deviceId}:
    get:
      operationId: getDeviceInfoByDeviceId
      summary: 获取设备详情
      tags:
      - Device Management
      parameters:
      - name: deviceId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: 业务数据 / Business payload
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: object
                    properties:
                      entityType:
                        type: string
                        description: 固定值：DEVICE
                      id:
                        type: string
                        description: 设备ID
                    description: 设备ID
                  createdTime:
                    type: number
                    description: 创建时间
                  tenantId:
                    type: object
                    properties:
                      entityType:
                        type: string
                        description: 固定值：TENANT
                      id:
                        type: string
                        description: 租户ID
                    description: 租户
                  name:
                    type: string
                    description: 设备标识
                  realName:
                    type: string
                    description: 设备名称
                  type:
                    type: string
                    description: 所属产品名称
                  productManageId:
                    type: object
                    properties:
                      entityType:
                        type: string
                        description: 固定值：TB_PRODUCT_MANAGE
                      id:
                        type: string
                        description: 产品ID
                    description: 产品
                  description:
                    type: string
                    description: 设备描述
                  image:
                    type: string
                    description: 图片
                  active:
                    type: boolean
                    description: 设备状态true在线false离线
                  lat:
                    type: string
                    description: 纬度
                  lon:
                    type: string
                    description: 经度
                  address:
                    type: string
                    description: 详细地址
                  nodeType:
                    type: string
                    description: 节点类型： DIRECT_DEVICE:直连设备，GATEWAY_DEVICE:网关设备，GATEWAY_CHILD_DEVICE:网关子设备
                  credentialsType:
                    type: string
                    description: 凭据类型：ACCESS_TOKEN，X509_CERTIFICATE，MQTT_BASIC，LWM2M_CREDENTIALS
                  lastActivityTime:
                    type: number
                    description: 最近在线时间
                  deviceCredentialsId:
                    type: string
                    description: 访问令牌
        default:
          description: 失败响应 / Failure envelope documented in 公共分类 › 状态码描述
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      externalDocs:
        description: 获取设备详情
        url: https://www.cosmoplat.com/help/detail/304/1038
components:
  schemas:
    Error:
      type: object
      description: 失败报文 / Failure envelope (公共分类 › 状态码描述)
      properties:
        status:
          type: integer
          description: 状态码，和 httpCode 一致 / status code, same as the HTTP status
        message:
          type: string
          description: 状态描述 / status description
        errorCode:
          type: integer
          description: 错误码 / error code
        timestamp:
          type: string
          format: date-time
          description: 时间戳 / timestamp
      examples:
      - status: 500
        message: 内部配置错误
        errorCode: 2
        timestamp: '2023-08-04T00:56:54.243+00:00'
externalDocs:
  description: COSMOPlat IoT platform documentation
  url: https://www.cosmoplat.com/help/detail/304/1012