QCS开放接口文档

QCS（QSL认证系统，QSL Certification System）对外开放接口文档：

基础信息

API地址

https://qcs.qsl.pub/api

基础响应模块

/**
 * API响应通用类型定义
 * @template T - 响应数据的类型
 */
export interface ApiResponse<T> {
  /** 响应数据 */
  data: T;
  /** 状态码 */
  code: number;
  /** 消息提示 */
  msg: string;
}

code状态码

默认请求数据类型

application/json

默认响应数据类型

json

Token模块

token模块部分数据需要加密，加密方式为sm4 cbc模式，padding为pkcs#7，加密后转为base64，使用token作为密钥

获取QCS台站列表

POST /oauth/personal_access_tokens/get_station_list

请求参数

请求示例

{
  "token": "MTIzNDU2"
}

响应参数

响应示例

{
  "data": [
    {
      "id": 1,
      "callsign": "BG7ZAG",
      "dxcc": "83",
      "grid": "OL50da",
      "itu": "44",
      "cq": "24",
      "station_location": "中国-海南",
      "first_qso_date": 1735660800000,
      "last_qso_date": null
    }
  ],
  "code": 200,
  "msg": "success"
}

导入qso记录

POST /oauth/personal_access_tokens/push_qso_by_token

请求参数

data

QsoList

请求示例

{
  "token": "MTIzNDU2",
  "iv": "w==",
  "data": "..."
}

const data = {
    station_id: 1,
    qso_list: [
        {
            callsign: "BG7ZAG",
            worked: "BG7ZAG",
            date: 1735660800000,
            mode: "SSB",
            band: "160m",
            freq: 160000000,
            rst_rcvd: "59",
            rst_sent: "59",
            satellite: null,
            propagation: null
        }
    ]
}

响应示例

{
  "data": "提交成功",
  "code": 200,
  "msg": "success"
}