确认

确认（Confirmation）

目录

• 该端点是什么（以及不是什么）
• 端点
• 筛选条件
• 示例
• 说明

Confirmation 资源是一个只读端点，列出令牌所有者已收到的 QSL 确认——每个 (QSO, 确认类型) 组合占一行。它对应 Web 界面中的 确认 页面：一个同时通过 LoTW 和 eQSL 确认的 QSO 在这里会显示为两行，与该表格中的显示完全一致。

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

注意

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

该端点是什么（以及不是什么）

它很容易与另外两个功能混淆，因此值得明确说明：

• 统计 ?profile=confirmations 返回按类型划分的聚合计数（有多少 QSO 被 LoTW 确认、被 eQSL 确认……）。本端点返回的是逐条 QSO 记录本身——呼号、日期、模式/波段以及匹配的类型——因此客户端可以呈现与人在浏览器中看到的相同视图。
• QSO 列表 的 ?qsl_filter= 参数会把 QSO 列表收窄为至少具有其中一种确认的 QSO，但它不显示哪个类型匹配，也不显示确认是何时到达的。本端点则可以。

端点

这是一个仅支持列表的端点。没有单条记录的 URL——像 /api/v2/confirmation/42 这样的请求会返回 404 not_found，因为确认本身没有稳定的 id（它由 QSO 及其类型来标识）。

筛选条件

所有参数都是可选的，并且可以组合使用：

?type= 的取值是小写键名（lotw、eqsl……）。而响应中的 type 字段携带的是人类可读的标签（LoTW、eQSL、QSL Card、QRZ.com、Clublog）——与 Web 界面使用的是同一套词。

since 与 qso_since 回答的是不同的问题，正如它们在 统计的确认主题 中一样。since 按确认到达的日期筛选——「本周进来了哪些确认」——会按类型分别应用各类型自己的收到日期列。qso_since / qso_until 则按 QSO 本身的日期筛选。两端均为闭区间，且可以单独使用。

无效的 type 取值或格式错误的日期会返回 400 validation_error。注意 HRDLog 不是一种确认类型：Wavelog 只是向它上传，并没有可列出的收到状态。

示例

curl "https://<WAVELOG_URL>/index.php/api/v2/confirmation?type=lotw,eqsl&since=2026-07-01" \
     -H "Authorization: Bearer wl2_your_token_here"

{
  "data": [
    {
      "qso_id": 48215,
      "callsign": "DL1ABC",
      "qso_date": "2026-07-28 18:30:00",
      "mode": "CW",
      "band": "20m",
      "gridsquare": "JN49",
      "confirmation_date": "2026-08-02",
      "type": "LoTW"
    },
    {
      "qso_id": 48200,
      "callsign": "OE3XYZ",
      "qso_date": "2026-07-26 19:05:00",
      "mode": "SSB",
      "band": "40m",
      "confirmation_date": "2026-08-01",
      "type": "eQSL"
    },
    {
      "qso_id": 48200,
      "callsign": "OE3XYZ",
      "qso_date": "2026-07-26 19:05:00",
      "mode": "SSB",
      "band": "40m",
      "confirmation_date": "2026-07-31",
      "type": "LoTW"
    },
    {
      "qso_id": 48190,
      "callsign": "K1ABC",
      "qso_date": "2026-07-25 10:12:00",
      "mode": "CW",
      "band": "2m",
      "gridsquare": "EM12",
      "sat_name": "AO-7",
      "sat_mode": "B",
      "confirmation_date": "2026-07-30",
      "type": "LoTW"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 100,
    "count": 4,
    "total": 4,
    "total_pages": 1,
    "has_more": false,
    "filters": {
      "type": ["lotw", "eqsl"],
      "since": "2026-07-01",
      "qso_since": null,
      "qso_until": null,
      "band": null,
      "mode": null,
      "callsign": null
    }
  }
}

说明

• 记录按确认时间从新到旧返回（先按 confirmation_date，再按 qso_id）。
• 核心字段（qso_id、callsign、qso_date、mode、band、confirmation_date、type）始终存在。可选字段——submode、gridsquare、vucc_grids、sat_name、sat_mode——为空时会被完全省略，因此负载只携带该 QSO 实际具有的内容。在上面的示例中，OE3XYZ 的记录没有可选字段，而卫星通联带有 sat_name / sat_mode / gridsquare。
• meta.filters 块会回显解析后的筛选条件，因此轮询程序无需跟踪自己发送过的查询就能解释这些记录。station_id 在内部解析，不会被回显。
• 结果按最新的在前排序；请使用分页（page / per_page）以及 has_more / total_pages 元数据来翻页遍历大结果集。

注意（集体台令牌受限于成员）

与 QSO 资源一样，低于干事级别的集体台成员只能看到自己操作员的 QSO 的确认。干事可以看到整个集体台的确认。