openapi: 3.2.0
info:
  title: COSMOPlat IoT Platform Open Attribute Data 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: Attribute Data
paths:
  /{entityType}/{entityId}/attributeProfilePage:
    get:
      operationId: getByEntityTypeByEntityIdAttributeProfilePage
      summary: 查询最新设备属性数据
      tags:
      - Attribute Data
      parameters:
      - name: entityType
        in: path
        required: true
        schema:
          type: string
      - name: entityId
        in: path
        required: true
        schema:
          type: string
      - name: entityType
        in: query
        required: true
        schema:
          type: string
        description: 固定值-DEVICE
      - name: entityId
        in: query
        required: true
        schema:
          type: string
        description: 设备ID
      - name: page
        in: query
        required: true
        schema:
          type: string
        description: 页码
      - name: pageSize
        in: query
        required: true
        schema:
          type: string
        description: 每页数据条数
      responses:
        '200':
          description: 业务数据 / Business payload
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        entityId:
                          type: object
                          properties:
                            entityType:
                              type: string
                              description: 固定值：DEVICE
                            id:
                              type: string
                              description: 设备ID
                          description: 设备ID
                        name:
                          type: string
                          description: 名称
                        cnName:
                          type: string
                          description: 名称
                        attrScope:
                          type: string
                          description: 范围
                        unit:
                          type: string
                          description: 单位
                        dataType:
                          type: string
                          description: 类型
                        description:
                          type: string
                          description: 描述
                        enDataType:
                          type: string
                          description: 英文数据类型
                        unitId:
                          type: string
                          description: 单位ID
                        dataTypeId:
                          type: string
                          description: 数据类型ID
                        dataLimit:
                          type: object
                          properties:
                            dataType:
                              type: string
                              description: 限制类型
                            booleanList:
                              type: array
                              items:
                                type: object
                                properties:
                                  value:
                                    type: string
                                  description:
                                    type: string
                                required:
                                - value
                                - description
                              description: 条件列表
                            max:
                              type: number
                              description: 最小值
                            min:
                              type: number
                              description: 最大值
                            unit:
                              type: string
                              description: 单位
                            unitId:
                              type: string
                              description: 单位ID
                            date:
                              type: boolean
                              description: 时间
                          description: 数据限制
                        value:
                          type: string
                          description: 值
                        id:
                          type: object
                          properties:
                            entityType:
                              type: string
                              description: 固定值：ATTRIBUTE_PROFILE
                            id:
                              type: string
                              description: ID
                          description: ID
                        createdTime:
                          type: number
                          description: 创建时间
                      required:
                      - entityId
                      - name
                      - cnName
                      - attrScope
                      - unit
                      - dataType
                      - description
                      - enDataType
                      - unitId
                      - dataTypeId
                      - dataLimit
                      - value
                      - id
                      - createdTime
                    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
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