创建设备异常报告

POST

/openapi/v0.9/manage/api/v1/organizations/{org_uuid}/manage-devices/reports

es-management-service

创建新的设备异常报告

请求参数

Path 参数

org_uuid

string

必需

Header 参数

x-user-token

string

必需

默认值:

X-Request-Id

string

可选

默认值:

{% mock 'uuid' %}

Body 参数application/json

appendix_files

array [object {3}]

附件文件列表

可选

file_name

string

文件名称

可选

file_object_key

string

文件存储key

可选

file_size

integer

文件大小

可选

device_topo

object

必需

设备拓扑信息
required: true

hosts

array [object {3}]

可选

index

string

TAS服务原始字段

可选

nodes

array [object {4}] | null

中继设备时必填

可选

parents

array [object {4}]

可选

error_start_time

integer

必需

错误开始时间
required: true
example: 1609459200
description: Unix时间戳(秒)

log_list

array [object {5}]

日志文件列表

可选

device_sn

string

设备sn

可选

list

array [object {4}]

可选

module

string

日志所属模块

可选

0飞行器 3机场

object_key

string

存储桶key

可选

result

integer

返回码

可选

非0表示失败

report_contact_information

object

必需

联系信息
required: true

string

可选

note 对联系方式进行加密

phone

string

可选

report_information

string

必需

异常报告信息
required: true
example: 设备出现异常情况...
description: 详细描述设备异常情况

report_uuid

string

可选

报告UUID(可选)
example: 4dbc6ef2-0e3c-4d47-8b32-552a44f573c5

示例

{
    "report_uuid": "af728299xxxx-845a-078777ed640a",
    "report_information": "{\"text\":\"仅仅测试002\",\"error_codes\":[\"test-002\"]}",
    "error_start_time": 1750067655,
    "device_topo": {
        "parents": [
            {
                "device_model_key": "3-3-0",
                "sn": "8Uxxx0122"
            }
        ],
        "hosts": [
            {
                "device_model_key": "0-100-1",
                "sn": "158xxxD24BJ0010065"
            }
        ]
    },
    "report_contact_information": {
        "email": "xxx@dji.com",
        "phone": "18xxxx954"
    },
    "appendix_files": [
        {
            "file_object_key": "device_logs/ca7480c9-xxxxx-9c504a7007cb/72164BC3-B8FB-6229-0CA8-BE97475DDD5E.png",
            "file_name": "72164BC3-xxxx-BE97475DDD5E.png",
            "file_size": 66365
        }
    ],
    "log_list": [],
    "domains": [
        {
            "key": 17500xxxxx9552,
            "value": "test-001"
        }
    ]
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST '/openapi/v0.9/manage/api/v1/organizations//manage-devices/reports' \
--header 'x-user-token;' \
--header 'X-Request-Id: {% mock '\''uuid'\'' %}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "report_uuid": "af728299xxxx-845a-078777ed640a",
    "report_information": "{\"text\":\"仅仅测试002\",\"error_codes\":[\"test-002\"]}",
    "error_start_time": 1750067655,
    "device_topo": {
        "parents": [
            {
                "device_model_key": "3-3-0",
                "sn": "8Uxxx0122"
            }
        ],
        "hosts": [
            {
                "device_model_key": "0-100-1",
                "sn": "158xxxD24BJ0010065"
            }
        ]
    },
    "report_contact_information": {
        "email": "xxx@dji.com",
        "phone": "18xxxx954"
    },
    "appendix_files": [
        {
            "file_object_key": "device_logs/ca7480c9-xxxxx-9c504a7007cb/72164BC3-B8FB-6229-0CA8-BE97475DDD5E.png",
            "file_name": "72164BC3-xxxx-BE97475DDD5E.png",
            "file_size": 66365
        }
    ],
    "log_list": [],
    "domains": [
        {
            "key": 17500xxxxx9552,
            "value": "test-001"
        }
    ]
}'

返回响应

🟢200成功

application/json

成功响应

Body

HTTP响应模板

code

integer

响应码

可选

message

string

响应消息

可选

data

object

响应数据

可选

creat_device_job_data

object | null

可选

error_log_list

array [object {5}] | null

错误日志列表

可选

report_uuid

string

可选

报告UUID
required: true
example: 4dbc6ef2-0e3c-4d47-8b32-552a44f573c5

track_number

string

可选

追踪编号
example: TN123456789

示例

{
    "code": 0,
    "message": "OK",
    "data": {
        "track_number": "0fbe5705-02ad-43d1-8c20-56a455321271",
        "report_uuid": "ace6e0bf-a4d6-4d50-bf97-1fb9949410cd",
        "error_log_list": null,
        "creat_device_job_data": {
            "bid": "cac86f19-2fa4-4971-9777-13b3e3784506",
            "sn": "8UUDMAQ00A0200",
            "biz_code": "fileupload_start",
            "status": "sent",
            "result": 0,
            "progress": {
                "percent": 0,
                "current_step": 0,
                "ext": null
            },
            "service_identifier": "fileupload_start"
        }
    }
}

修改于 2025-06-27 12:02:06