cqGMA Logging API Documentation

Overview

The cqGMA Logging API allows software developers to:

• insert QSOs
• update QSOs
• delete QSOs
• upload activator logs
• upload chaser logs
• activate LIVE logging

API URL:

https://www.cqgma.org/api/log/

Support:

support@cqgma.org

---

JSON Upload Structure

{
  "USER": "DR0ABC",
  "PSWD": "*",
  "DUMP": 0,
  "LIVE": 0,
  "LOGC": 123,
  "QSO": []
}

---

Main Parameters

| Parameter | Description |
|---|---|
| USER | cqGMA username |
| PSWD | cqGMA password |
| DUMP | 0 = no dump, 1 = HTML debug output |
| LIVE | enables LIVE logging |
| LOGC | software identifier |
| QSO | array with QSO records |

---

QSO Structure

{
  "ID": "1629754292",
  "DATE": "20210821",
  "UTC": "1500",
  "MYCALL": "DR0ABC/P",
  "OPERATOR": "DC1BF",
  "MYLOC": "JO42AE",
  "MAINREF": "DM/NS-036",
  "WKDCALL": "DL0GMA",
  "BAND": "2M",
  "MODE": "CW",
  "RSTS": "599",
  "RSTR": "599",
  "WKDREF": "DA/NW-066",
  "ACTION": "A"
}

---

Required Fields

Activator QSO

Required:

• ID
• DATE
• UTC
• MYCALL
• MAINREF
• WKDCALL
• MHZ or BAND
• MODE
• RSTS
• RSTR

Chaser QSO

Required:

• ID
• DATE
• UTC
• MYCALL
• WKDCALL
• WKDREF
• MHZ or BAND
• MODE
• RSTS
• RSTR

---

ACTION Parameter

| Value | Meaning |
|---|---|
| A | Add QSO |
| U | Update QSO |
| D | Delete QSO |

If ACTION is omitted, default is:

A

---

Satellite Example

{
  "PROPAGATION": "SAT",
  "SATNAME": "QO-100",
  "SATMODE": "SX"
}

---

Delete QSO Example

{
  "ID": "1629754294",
  "ACTION": "D"
}

---

Multiple QSO Upload

The API supports multiple QSOs inside one JSON upload.

---

Return JSON

{
  "CHECKLOG":"all fine",
  "ACTQSOINS":"0",
  "ACTQSOUPD":"0",
  "ACTQSODEL":"0",
  "CHSQSOINS":"0",
  "CHSQSOUPD":"0",
  "CHSQSODEL":"0",
  "EXIT_ERROR":"NONE"
}

---

Notes

• QSO ID is essential
• UNIX timestamp recommended as ID
• JSON must be UTF-8 encoded
• API supports activator and chaser uploads
• LIVE logging immediately appears on cqGMA spotting services
• There are no spot-style rate limits for the logging API, because several QSOs may be uploaded or logged within a short time.

---

Contact

CQGMA website:

https://www.cqgma.org

Support:

support@cqgma.org