Développement web • Python • Radio amateur

Django : le framework web Python expliqué simplement

De la théorie à la pratique, en passant par la radio amateur — et une API concrète disponible sur django.jerko.fr.

Un framework, c’est quoi exactement ? Imaginez que vous construisez une maison. Vous pourriez façonner chaque brique vous-même, concevoir votre propre plomberie, inventer vos propres techniques de maçonnerie. Ou bien vous pouvez utiliser des matériaux standard, des plans éprouvés, et vous concentrer sur ce qui rend votre maison unique. Un framework web, c’est pareil : il fournit la structure, les outils et les conventions pour que vous n’ayez plus qu’à construire ce qui vous appartient.

Django vs PHP pour un radioamateur ? Si vous connaissez déjà PHP/WordPress, la transition demande un investissement initial. Mais dès que vous devez traiter des données structurées en volume — logs ADIF, trames JSON d’un SDR, exports WSPR — Python et Django s’avèrent nettement plus confortables : la syntaxe est plus lisible, les bibliothèques scientifiques (NumPy, Pandas) sont disponibles, et l’ORM évite les jointures SQL manuelles.

# Récupérer les articles du blog via l'API REST
curl -s https://django.jerko.fr/api/articles/ | python3 -m json.tool

# Réponse JSON réelle (extrait)
{
  "count": 6,
  "next": null,
  "results": [
    {
      "id": 1,
      "titre": "Circuits LC — Résonance en Radioamateurisme",
      "slug": "circuit-lc",
      "categorie": "radio",
      "date": "2026-04-11",
      "auteur": "admin"
    },
    {
      "id": 2,
      "titre": "WSPR — Weak Signal Propagation Reporter",
      "slug": "wspr-weak-signal-propagation-reporter",
      "categorie": "radio",
      "date": "2026-04-11",
      "auteur": "admin"
    },
    {
      "id": 3,
      "titre": "APRS — Automatic Packet Reporting System",
      "slug": "aprs-automatic-packet-reporting-system",
      "categorie": "radio",
      "date": "2026-04-11",
      "auteur": "admin"
    }
  ]
}

// Afficher les articles radio depuis l'API dans une page WordPress
fetch('https://django.jerko.fr/api/articles/?categorie=radio')
  .then(r => r.json())
  .then(data => {
    console.log(`${data.count} articles dans la catégorie radio`);
    data.results.forEach(article => {
      console.log(article.titre, article.date);
    });
  });

# dxcluster/models.py
from django.db import models

class Spot(models.Model):
    dx_call    = models.CharField(max_length=20)   # indicatif DX spotter
    freq       = models.FloatField()               # fréquence en kHz
    dx_station = models.CharField(max_length=20)   # station spottée
    comment    = models.CharField(max_length=128, blank=True)
    timestamp  = models.DateTimeField(auto_now_add=True)

    class Meta:
        ordering = ['-timestamp']   # les plus récents en premier

    def __str__(self):
        return f"{self.dx_call} — {self.dx_station} — {self.freq} kHz"

# Les 10 derniers spots
curl -s https://cluster.jerko.fr/api/spots/?limit=10 | python3 -m json.tool

{
  "count": 4821,
  "results": [
    {
      "dx_call":    "F4HXN",
      "freq":       14025.0,
      "dx_station": "TM5REF",
      "comment":    "59 CW TNX",
      "timestamp":  "2026-05-19T08:42:11Z"
    }
  ]
}

<!-- Bloc HTML Gutenberg -->
<div id="dx-spots" style="font-family:DM Sans,sans-serif;"></div>

<script>
(function() {
  fetch('https://cluster.jerko.fr/api/spots/?limit=10')
    .then(r => r.json())
    .then(data => {
      document.getElementById('dx-spots').innerHTML =
        '<table><tr><th>Spotter</th><th>DX</th><th>Fréq. kHz</th><th>Info</th></tr>' +
        data.results.map(s =>
          `<tr><td>${s.dx_call}</td><td><b>${s.dx_station}</b></td>
               <td>${s.freq}</td><td>${s.comment}</td></tr>`
        ).join('') + '</table>';
    });
})();
</script>

Ce widget peut s’enrichir : filtrage par bande, rafraîchissement automatique toutes les 30 secondes avec setInterval(), mise en évidence des nouvelles entités DXCC… Le tout sans modifier WordPress — uniquement en jouant sur l’API Django et quelques lignes de JavaScript.

mon-api/
├── manage.py          # CLI Django (migrations, runserver…)
├── mon_api/            # Configuration principale
│   ├── settings.py    # BDD, apps installées, debug, CORS…
│   ├── urls.py        # Routage global des URLs
│   └── wsgi.py        # Point d'entrée Gunicorn
└── logbook/            # Exemple d'application Django
    ├── models.py      # Définition de la table QSO
    ├── serializers.py # Conversion objet Python ↔ JSON
    ├── views.py       # Logique des endpoints API
    └── urls.py        # Routes locales à cette app

# logbook/models.py
from django.db import models

class QSO(models.Model):
    callsign  = models.CharField(max_length=20)
    band      = models.CharField(max_length=10)   # ex: "40m"
    mode      = models.CharField(max_length=10)   # FT8, SSB, CW…
    locator   = models.CharField(max_length=8, blank=True)
    rst_sent  = models.IntegerField(default=59)
    rst_rcvd  = models.IntegerField(default=59)
    date_time = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return f"{self.callsign} – {self.band} – {self.mode}"

<!-- À coller dans un bloc HTML Gutenberg -->
<div id="dx-widget" style="font-family:DM Sans,sans-serif;padding:1rem;"></div>

<script>
(function() {
  const API = 'https://django.jerko.fr/api/spots/?limit=10';
  fetch(API)
    .then(r => r.json())
    .then(data => {
      const el = document.getElementById('dx-widget');
      el.innerHTML = data.results.map(s =>
        `<p><strong>${s.dx}</strong> — ${s.freq} kHz — ${s.spotter}</p>`
      ).join('');
    });
})();
</script>

Astuce CORS — Pour que le navigateur accepte la requête vers un domaine différent (django.jerko.fr depuis f4hxn.fr), il faut autoriser les origines dans Django :

# settings.py
INSTALLED_APPS += ['corsheaders']
MIDDLEWARE = ['corsheaders.middleware.CorsMiddleware', ...autres...]
CORS_ALLOWED_ORIGINS = ['https://f4hxn.fr', 'https://frimousse.net']

Ressources pour aller plus loin

Documentation officielle : docs.djangoproject.com • DRF : django-rest-framework.org • CORS : pypi.org/project/django-cors-headers

Un grand merci à Yoann F4JTV qui m’a fait découvrir Django et m’a donné l’envie de creuser ce framework.

C’est souvent par un échange entre radioamateurs passionnés qu’on franchit le pas vers de nouveaux horizons techniques — et Django en est la preuve.