查询

查询（Lookup）

Lookup 资源用于查询单个呼号或网格，范围限定在令牌所有者自己的日志。呼号查询是 v1 lookup / private_lookup 端点的 v2 对应物（用于电台控制叠加层、DX 集群客户端等）；网格查询取代 v1 的 logbook_check_grid。

基础路径： /api/v2/lookup
作用域： lookup:read
起始版本： 3.1.0

注意

请先阅读 API v2 概览，了解认证、响应封装与错误码。

端点

动词	路径	作用域	用途	起始版本
`GET`	`/api/v2/lookup?callsign=…`	`lookup:read`	查询一个呼号	3.1.0
`GET`	`/api/v2/lookup?grid=…`	`lookup:read`	查询某个网格的已通联/已确认状态	3.1.0
`GET`	`/api/v2/lookup?grid=all`	`lookup:read`	列出所有已通联的网格	3.1.0

呼号始终作为查询参数传递，从不作为路径片段——/api/v2/lookup/DL1ABC 会返回 404 not_found，因为 Lookup 没有可寻址的单项。这样一来，包含 / 的呼号（便携或带 DXCC 前缀的呼号，如 DL1ABC/P 或 W/DL1ABC）才能正常工作，而路径片段做不到这一点：大多数 Web 服务器会拒绝编码后的斜杠（%2F）。

GET /api/v2/lookup 既不带 callsign 也不带 grid 时，返回 400 validation_error。

呼号查询

查询参数

参数	默认值	说明
`callsign`	—	要查询的呼号（此形式必填）
`detail`	`basic`	`full` 或 `basic`（见下文）
`band`	—	用于按波段的已通联/已确认标志的波段（例如 `20m`）
`mode`	—	用于按模式的已通联/已确认标志的模式（例如 `FT8`）
`callbook`	—	设为 `true` 时包含外部呼号簿数据（会额外发起一次 HTTP 查询）
`station_ids`	全部拥有的	以逗号分隔的台站位置 id，用于把已通联/已确认状态限定在其范围内；不属于你的 id 会被忽略
`date`	今天	`YYYY-MM-DD`：解析 DXCC 所依据的日期，会在 `meta.date` 中返回。对过去的 QSO 请使用该 QSO 的日期，这样对于那些 DXCC 例外仅在一段时期内有效的呼号（例如一次 DXpedition），在该时期结束后仍能正确解析。非法日期会返回 `400 validation_error`。 3.2.5

详细级别

`full`

包含 basic 返回的一切，外加按波段/模式的已通联与已确认标志、DXCC 确认状态，以及——当 callbook=true 时——呼号簿数据。这与 v1 的 private_lookup 端点一致。

curl "https://<WAVELOG_URL>/index.php/api/v2/lookup?callsign=DL1ABC&detail=full&band=20m&mode=FT8" \
     -H "Authorization: Bearer wl2_your_token_here"

{
  "data": {
    "callsign": "DL1ABC",
    "dxcc": "FEDERAL REPUBLIC OF GERMANY",
    "dxcc_id": "230",
    "dxcc_lat": "51",
    "dxcc_long": "10",
    "dxcc_cqz": "14",
    "dxcc_flag": "🇩🇪",
    "cont": "EU",
    "name": "",
    "gridsquare": "",
    "location": "",
    "iota_ref": "",
    "state": "",
    "us_county": "",
    "qsl_manager": "",
    "bearing": "",
    "call_worked": false,
    "call_worked_band": false,
    "call_worked_band_mode": false,
    "lotw_member": false,
    "dxcc_confirmed_on_band": false,
    "dxcc_confirmed_on_band_mode": false,
    "dxcc_confirmed": true,
    "call_confirmed": false,
    "call_confirmed_band": false,
    "call_confirmed_band_mode": false,
    "suffix_slash": "",
    "dxcc_ituz": 28
  },
  "meta": { "detail": "full", "date": "2026-10-21" }
}

如果该呼号此前通联过，会填入所有者已存储的 name、gridsquare、location、iota_ref、state、us_county 和 qsl_manager，并为该网格附加一个 latlng 值，而 call_worked* / call_confirmed* 标志会反映所请求的 band/mode。只有当实体有已知 ITU 分区时才会出现 dxcc_ituz；只有当 callbook=true 时才会出现 callbook。

`basic`（默认）

DXCC 推导结果，加上（若此前通联过）所有者的网格/姓名——不含按波段/模式的历史。这与 DXClusterAPI 所使用的 v1 lookup 端点一致，是开销更小的调用。

curl "https://<WAVELOG_URL>/index.php/api/v2/lookup?callsign=DL1ABC&detail=basic" \
     -H "Authorization: Bearer wl2_your_token_here"

{
  "data": {
    "callsign": "DL1ABC",
    "dxcc": "FEDERAL REPUBLIC OF GERMANY",
    "dxcc_id": "230",
    "dxcc_lat": "51",
    "dxcc_long": "10",
    "dxcc_cqz": "14",
    "dxcc_flag": "🇩🇪",
    "cont": "EU",
    "name": "",
    "gridsquare": "",
    "location": "",
    "iota_ref": "",
    "state": "",
    "us_county": "",
    "qsl_manager": "",
    "bearing": "",
    "workedBefore": false,
    "lotw_member": false,
    "suffix_slash": ""
  },
  "meta": { "detail": "basic", "date": "2026-10-21" }
}

网格查询

GET /api/v2/lookup?grid=<grid> ——该网格在你的日志中是否已通联或已确认？（取代 v1 的 logbook_check_grid 端点。）

参数	说明
`grid`	要查询的网格（此形式必填）
`band`	可选的波段筛选，例如 `20m`
`cnfm`	可选的确认来源：`qsl`、`lotw` 或 `eqsl`——其他任何值都会返回 `400 validation_error`
`logbook_id`	可选：限定在某个你拥有的日志（他人的 id 会返回 `403 forbidden`）

curl "https://<WAVELOG_URL>/index.php/api/v2/lookup?grid=JN47&cnfm=lotw" \
     -H "Authorization: Bearer wl2_your_token_here"

{ "data": { "gridsquare": "JN47", "result": "Confirmed" }, "meta": { "type": "grid" } }

result 为以下之一：

值	含义
`Not Found`	该网格尚未通联
`Found`	已通联（未请求 `cnfm` 时返回）
`Worked`	已通联，但未通过所请求的 `cnfm` 来源确认
`Confirmed`	已通过所请求的 `cnfm` 来源确认

全部已通联网格

GET /api/v2/lookup?grid=all ——不检查单个网格，而是返回你日志中已通联的每一个网格。（取代 v1 的 logbook_get_worked_grids 端点。）

参数	说明
`grid`	字面值 `all`（此形式必填）
`band`	可选的波段筛选，例如 `20m`；`SAT` 限定为卫星 QSO
`cnfm`	可选的确认来源：`qsl`、`lotw` 或 `eqsl`——其他任何值都会返回 `400 validation_error`
`logbook_id`	可选：限定在某个你拥有的日志（他人的 id 会返回 `403 forbidden`）

curl "https://<WAVELOG_URL>/index.php/api/v2/lookup?grid=all&band=20m" \
     -H "Authorization: Bearer wl2_your_token_here"

{
  "data": { "grids": ["JN47", "JO30"], "count": 2 },
  "meta": { "type": "worked_grids", "band": "20m", "cnfm": null }
}

来自 VUCC_GRIDS 字段的网格也会包含在内。所有值都会转为大写并截断为前四个字符，因此列表中每个已通联的字段只出现一次。

集体台令牌

查询是从日志中回答「我以前通联过这个吗」，因此它遵循与 QSO 资源相同的边界。对于低于干事级别的集体台令牌，只考虑当前操作成员自己的 QSO：

当唯一的匹配属于其他操作员时，?callsign= 会报告 workedBefore: false（在 detail=full 时是 call_worked: false），并且不会从该记录返回姓名、QTH（电台位置）或网格定位。
?grid= 与 ?grid=all 会忽略其他操作员的 QSO。

干事可以看到整个集体台的日志。DXCC 数据由呼号本身推导而来，永远不受限制。

Wavelog 手册（中文版） / 查询 0 字 0 行 bg8lng

2026-10-21T12:42:36.387105208Z 2026-10-21T12:44:03.688524422Z

查询

端点