API 接口文档

一、基础信息

二、搜索接口

请求参数

请求示例

GET /api.php?action=search&q=御3&limit=5&nonce=a1b2c3d4
Host: dji.hxos7.xyz
X-Api-Key: 3298166885
X-Timestamp: 1762953600
X-Sign: 8f3a2b...(HMAC_SHA256("search|1762953600|a1b2c3d4", "3298166885"))

成功响应示例 (code:0)

{
  "code": 0,
  "msg": "ok",
  "data": [
    {
      "id": "mavic3pro",
      "name_cn": "DJI Mavic 3 Pro",
      "name_en": "DJI Mavic 3 Pro",
      "category": "航拍旗舰",
      "release": "2023-04-25",
      "icon": "icons/mavic3pro.jpg"
    },
    {
      "id": "mavic3classic",
      "name_cn": "DJI Mavic 3 Classic",
      "name_en": "DJI Mavic 3 Classic",
      "category": "航拍旗舰",
      "release": "2022-11-02",
      "icon": "icons/mavic3classic.jpg"
    },
    {
      "id": "mavic3",
      "name_cn": "DJI Mavic 3",
      "name_en": "DJI Mavic 3",
      "category": "航拍旗舰",
      "release": "2021-11-05",
      "icon": "icons/mavic3.jpg"
    },
    {
      "id": "mavic3e",
      "name_cn": "DJI Mavic 3E 行业版",
      "name_en": "DJI Mavic 3 Enterprise",
      "category": "行业",
      "release": "2022-09-27",
      "icon": "icons/mavic3e.jpg"
    },
    {
      "id": "mavic3t",
      "name_cn": "DJI Mavic 3T 行业版",
      "name_en": "DJI Mavic 3 Thermal",
      "category": "行业",
      "release": "2022-09-27",
      "icon": "icons/mavic3t.jpg"
    }
  ]
}

字段说明

更多搜索示例

q=农业     → 大疆 T50 / T25 / T40 农业无人飞机 (4条)
q=植保     → T50 / T25 / MG-1S (3条)
q=穿越机   → DJI FPV / Avata 2 (2条)
q=249克    → DJI Mini 4 Pro (1条)
q=精灵     → Phantom 4 / 4 Pro / 3 (4条)
q=哈苏     → Mavic 3 / Mavic 2 Pro (2条)
q=mini     → Mini 4 Pro / 3 Pro / 3 / 2 SE / 2 / 4K / Mavic Mini (7条)
q=mavic    → Mavic 全系 13 条

三、机型详情接口

请求参数

请求示例

GET /api.php?action=detail&id=mini4pro&nonce=x9y8z7w6
X-Api-Key: 3298166885
X-Timestamp: 1762953600
X-Sign: ...(HMAC_SHA256("detail|1762953600|x9y8z7w6", "3298166885"))

成功响应示例 (code:0)

{
  "code": 0,
  "msg": "ok",
  "data": {
    "id": "mini4pro",
    "name_cn": "DJI Mini 4 Pro",
    "name_en": "DJI Mini 4 Pro",
    "category": "消费级",
    "release": "2023-09-25",
    "icon": "icons/mini4pro.jpg",
    "params": {
      "重量": "249 g",
      "最大飞行时间": "34 分钟(普通电池)/ 45 分钟(长续航电池)",
      "最大图传距离": "20 km",
      "相机传感器": "1/1.3 英寸 CMOS,4800 万像素",
      "视频规格": "4K/60fps HDR、4K/100fps 慢动作",
      "避障系统": "全向主动避障(前/后/左/右/上/下)",
      "图传": "DJI O4",
      "最大抗风": "10.7 m/s(5 级风)",
      "最大飞行速度": "16 m/s(运动挡)",
      "存储": "支持 microSD 卡(最大 512GB)"
    },
    "accessories": [
      "智能飞行电池",
      "长续航智能飞行电池",
      "双向充电管家",
      "DJI RC 2 带屏遥控器",
      "DJI RC-N2 遥控器",
      "ND 镜套装(ND8/16/32/64)",
      "螺旋桨",
      "收纳包",
      "充电头 30W"
    ]
  }
}

字段说明

错误响应示例 (机型不存在)

{
  "code": 404,
  "msg": "model not found",
  "data": []
}

四、全机型列表接口

请求示例

GET /api.php?action=models&nonce=m5n4b3v2
X-Api-Key: 3298166885
X-Timestamp: 1762953600
X-Sign: ...(HMAC_SHA256("models|1762953600|m5n4b3v2", "3298166885"))

成功响应示例 (共 88 条,此处截取 3 条)

{
  "code": 0,
  "msg": "ok",
  "data": [
    { "id": "mavic4pro",     "name_cn": "DJI Mavic 4 Pro",     "release": "2025-05-13", "category": "航拍旗舰" },
    { "id": "flip",          "name_cn": "DJI Flip",            "release": "2025-01-14", "category": "消费级"   },
    { "id": "air3s",         "name_cn": "DJI Air 3S",          "release": "2024-10-15", "category": "消费级"   }
    // ... 共 88 款,按发布时间倒序
  ]
}

五、错误码一览

六、完整调用流程(Python 实测示例)

import time, hmac, hashlib, urllib.parse, urllib.request, json

API_KEY  = '3298166885'
API_URL  = 'https://dji.hxos7.xyz/api.php'

def call_api(action, **params):
    ts    = int(time.time())
    nonce = 'n' + str(int(time.time()*1000))[-8:]   # 随机串,每次不同
    sign  = hmac.new(API_KEY.encode(),
                     f'{action}|{ts}|{nonce}'.encode(),
                     hashlib.sha256).hexdigest()
    params.update({'action': action, 'nonce': nonce})
    url = API_URL + '?' + urllib.parse.urlencode(params)
    req = urllib.request.Request(url, headers={
        'X-Api-Key':   API_KEY,
        'X-Timestamp': str(ts),
        'X-Sign':      sign,
        'User-Agent':  'Mozilla/5.0',
    })
    with urllib.request.urlopen(req, timeout=10) as r:
        return json.loads(r.read().decode())

# 1. 搜索
r = call_api('search', q='御3', limit=5)
print(r['code'], r['msg'])          # 0 ok
print(len(r['data']))               # 5
print(r['data'][0]['name_cn'])      # DJI Mavic 3 Pro

# 2. 取第一条的 id 查详情
first_id = r['data'][0]['id']
d = call_api('detail', id=first_id)
print(d['data']['params']['重量'])    # 958 g
print(d['data']['accessories'])     # 配件清单数组

# 3. 全列表
m = call_api('models')
print(len(m['data']))               # 88