# 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

```json
{
  "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

```json
{
  "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:

```text
A
```

---

# Satellite Example

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

---

# Delete QSO Example

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

---

# Multiple QSO Upload

The API supports multiple QSOs inside one JSON upload.

---

# Return JSON

```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
```