领朋 API 平台

1. 基本信息

2. 签名算法

sign = HMAC_SHA256(apikey + "|" + ts, api_secret)
        ^ 结果取 64 位小写 hex；api_secret 即你的 API Secret

# 举例
apikey  = "5f3c9a1b7d2e4f6089abcdef01234567"
ts      = "202609140850"        # UTC 时间，格式 YYYYMMDDHHmm
待签串   = "5f3c9a1b7d2e4f6089abcdef01234567|202609140850"
sign    = HMAC_SHA256_HEX(api_secret, 待签串)

# 完整请求（把 3 个鉴权参数拼在 URL 上即可）
GET https://api.linkpoon.com/api/gps/latest
    ?linkpoon_num=8505011843
    &apikey=5f3c9a1b7d2e4f6089abcdef01234567
    &ts=202609140850
    &sign=c792a4b15aed58583bef33555ea28e9c7e83d2c46255ca9513bda7e489aea2fa

· ts 必须是 UTC 时间（北京时间 = UTC+8。例：本地 2026-09-14 16:50 → ts = 202609140850）
· ts 与服务器相差不超过 5 分钟，否则返回 401
· API Secret 只在生成 Key 时显示一次，请妥善保存（遗失只能重新生成）
· 调用来源受项目白名单限制，请提前把服务器出口 IP 告知平台

3. 接口一：查询设备最新位置

GET /api/gps/latest

URL 里同时带了鉴权参数（apikey / ts / sign）， 签名规则见上方第 2 节。下方「在线调试」会自动生成带真实签名的完整 URL，可直接复制使用。

{
  "code": 0,
  "data": {
    "linkpoonNum": "8505011843",
    "deviceSn": "",
    "longitude": "114.081833",
    "latitude": "22.535995",
    "speed": "0.13",
    "direction": "352.07",
    "time": "2026-09-14 01:29:27"
  }
}

4. 接口二：查询历史轨迹

GET /api/gps/history

{
  "code": 0,
  "source": "live",
  "complete": true,
  "count": 60,
  "cached": 60,
  "data": [
    { "linkpoonNum": "8505011843", "longitude": "104.668930", "latitude": "31.515760",
      "speed": "0", "direction": "0", "time": "2026-08-25 10:40:30" },
    { "linkpoonNum": "8505011843", "longitude": "104.669120", "latitude": "31.515802",
      "speed": "0.13", "direction": "352.07", "time": "2026-08-25 10:45:11" }
  ]
}

按定位时间升序返回；时间是字符串，比较时请按 yyyy-MM-dd HH:mm:ss 格式处理。
· complete=true 表示该时间段已全部拉完；false 表示查询超时提前返回， 数据可能不全（建议缩小时间范围后重试）
· source=live 耗时较长（领朋协议每页最多 24 条，需逐页翻取，通常 10～40 秒）； 结果会自动沉淀到本地库，之后用 source=local 查询同一时间段即可秒回
· source=live 时若领朋链路不可用，会自动降级为本地数据，响应里的 source 会标明实际来源

5. 接口三：查询整组设备的当前位置

GET /api/gps/group

一次取回本项目群组内全部设备的当前位置，免去逐个调用 /latest，适合做设备总览或地图批量打点。

{
  "code": 0,
  "count": 2,      // 本次返回的设备数
  "total": 2,      // 项目内设备总数
  "data": [
    { "linkpoonNum": "8505011843", "deviceSn": "",
      "longitude": "104.668930", "latitude": "31.515760",
      "speed": "10.0", "direction": "0.0",
      "time": "2026-08-28 17:44:27", "hasData": true },
    { "linkpoonNum": "8505011873", "deviceSn": "",
      "longitude": null, "latitude": null, "speed": null,
      "direction": null, "time": null, "hasData": false }
  ]
}

设备清单 = 本项目登记的设备 ∪ 领朋组内成员 ∪ 已有定位数据的设备（三者合并去重）。
说明：领朋底层协议不支持按组订阅 GPS（协议限制），平台已在服务端按「组成员名单 → 逐个采集」统一入库，您一次调用即可取回整组。
提示：平台只对已登记的设备建立采集，新设备请告知平台添加，否则拿不到它的定位。

6. 错误码

7. 在线调试

填写参数后点「生成签名并调用」，下方会给出完整请求 URL（已带签名）、签名参数、curl 命令和真实响应，可直接复制给贵方工程师。