API del Log Online

Documentazione dell'API per inviare i tuoi QSO FT2 a community.ft2.it da un client esterno (come FT2 Log Bridge) o da un tuo script.

Autenticazione

Ogni richiesta richiede la tua API key personale, da generare nella Dashboard. Inviala nell'header X-API-Key oppure come token Bearer:

X-API-Key: ft2_xxxxxxxxxxxxxxxxxxxx
Authorization: Bearer ft2_xxxxxxxxxxxxxxxxxxxx

URL di base: https://community.ft2.it

La tua API key è personale: chi la possiede può inviare QSO a tuo nome. Non condividerla mai.

Ottieni la tua API key

Endpoint

GET /api/ping

Verifica che la tua API key sia valida. Restituisce il tuo nominativo e numero socio.

curl -H "X-API-Key: YOUR_KEY" https://community.ft2.it/api/ping

{ "ok": true, "callsign": "IU8LMC", "member_number": 1 }

POST /api/qso

Invia uno o più QSO. Accetta un singolo oggetto JSON, un array oppure {qsos:[...]}.

Campi di un QSO

Campo	Obbligatorio	Descrizione
`callsign_worked`	Obbligatorio	Nominativo contattato (maiuscolo). L'unico campo obbligatorio.
`mode`	Opzionale	Modo operativo: è accettato solo FT2 (FT2, MFSK o assente). Gli altri modi vengono rifiutati.
`datetime`	Opzionale	Data e ora del QSO in UTC (ISO 8601, es. 2026-06-28T12:00:00Z). Se assente, si usa l'ora corrente.
`frequency`	Opzionale	Frequenza in MHz (es. 14.074).
`band`	Opzionale	Banda (es. 20m). Se assente, viene ricavata dalla frequenza.
`rst_sent`, `rst_rcvd`	Opzionale	Rapporti RST inviato e ricevuto (es. -15).
`grid_worked`	Opzionale	Grid locator (Maidenhead) della stazione contattata (es. JO31).
`dxcc_worked`	Opzionale	Numero entità DXCC. Se assente, viene ricavato dal prefisso del nominativo.
`country_worked`	Opzionale	Nome della nazione. Se assente, viene ricavato dal prefisso del nominativo.
`comment`	Opzionale	Nota libera per il QSO.

Esempio (curl)

curl -X POST https://community.ft2.it/api/qso \
  -H "X-API-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"callsign_worked":"DL1ABC","datetime":"2026-06-28T12:00:00Z","mode":"FT2","band":"20m","frequency":14.074,"grid_worked":"JO31"}'

Risposta

{ "ok": true, "received": 1, "imported": 1, "duplicates": 0, "rejected_non_ft2": 0, "new_awards": [] }

GET /api/recent

Feed pubblico (nessuna chiave): gli ultimi QSO registrati in diretta nelle ultime 24 ore.

Note importanti

Sono accettati solo QSO in modo FT2: gli altri modi (FT8, FT4, ...) vengono rifiutati.
Devi aver confermato il tuo indirizzo email, altrimenti l'invio è bloccato (errore 403).
I QSO duplicati (stesso socio, nominativo, data e ora) vengono ignorati automaticamente.
Massimo 1000 QSO per richiesta; limite di frequenza circa 240 richieste al minuto per IP.
Se non indichi DXCC/nazione, vengono ricavati dal prefisso del nominativo.

Errori comuni

Codice	Descrizione
`401`	API key mancante o non valida.
`403`	Indirizzo email non ancora confermato.
`422`	QSO non in modo FT2: è accettato solo FT2.
`413`	Troppi QSO in un'unica richiesta (max 1000).
`429`	Troppe richieste: rallenta.

Guida al client desktop Ottieni la tua API key