API OGHub
Les actualités, flux RSS, jeux et cartes d'OGHub, en lecture libre pour tes sites, bots et applications.
Pour commencer
Aucune clé, aucun compte : une requête GET suffit. Les réponses sont en JSON (ou XML pour les flux), en UTF-8.
Adresse de base
https://api.oghub.fr/v1curl "https://api.oghub.fr/v1/news?lang=en&limit=3"Flux à abonner
Colle ces adresses dans ton lecteur RSS, Discord (bot de flux), Slack ou IFTTT. Ajoute ?lang=fr pour le français, ?category=<slug> pour un jeu précis.
RSS https://api.oghub.fr/v1/feeds/news.xml
Atom https://api.oghub.fr/v1/feeds/news.atom
JSON https://api.oghub.fr/v1/feeds/news.jsonRoutes
| GET | Paramètres | |
|---|---|---|
| /v1/news | lang, category, limit, page | Actualités, du plus récent au plus ancien (résumé, image, catégories, lien). |
| /v1/news/categories | — | Catégories d'actualités (utilisables avec ?category=). |
| /v1/news/{slug} | lang | Un article complet, en Markdown et en HTML. |
| /v1/feeds/news.xml | lang, category, limit | Flux RSS 2.0 des actualités, article complet inclus. |
| /v1/feeds/news.atom | lang, category, limit | Flux Atom des actualités. |
| /v1/feeds/news.json | lang, category, limit | Flux JSON Feed 1.1 des actualités. |
| /v1/games | limit, page, all | Catalogue des jeux (dates, plateformes, images, liens). all=1 pour tout le catalogue. |
| /v1/games/{slug} | — | Un jeu du catalogue. |
| /v1/maps | lang | Cartes interactives publiées, avec leur adresse sur OGHub. |
Exemples
JavaScript
const res = await fetch("https://api.oghub.fr/v1/news?lang=en&limit=5")
const { data, meta } = await res.json()
for (const article of data) {
console.log(article.title, article.url)
}
console.log(meta.total, "articles")Python
import requests
feed = requests.get("https://api.oghub.fr/v1/feeds/news.json", params={"lang": "en", "limit": 10}).json()
for item in feed["items"]:
print(item["title"], item["url"])JSON
{
"data": [
{
"id": 123,
"slug": "dmz-is-not-an-arc-raiders-copy",
"title": "DMZ is not an Arc Raiders copy",
"excerpt": "Since the release of Modern Warfare 4…",
"banner": "https://www.oghub.fr/…",
"url": "https://www.oghub.fr/en/news/dmz-is-not-an-arc-raiders-copy",
"language": "en",
"published_at": "2026-10-26T16:54:16+00:00",
"categories": [{ "slug": "cod-mw4", "name": "COD: Modern Warfare 4" }]
}
],
"meta": { "page": 1, "limit": 20, "total": 87, "pages": 5, "language": "en" }
}Règles d'usage
- 120 requêtes par minute et par adresse IP. Au-delà, l'API répond 429 avec un en-tête Retry-After.
- Les réponses sont mises en cache 2 minutes (Cache-Control, ETag, 304) : inutile d'interroger plus souvent.
- CORS ouvert : tu peux appeler l'API directement depuis un navigateur.
- Lecture seule. Seul le contenu public est exposé ; les articles réservés aux membres ne le sont jamais.
- Merci de citer OGHub avec un lien vers l'article ou la page d'origine (champ url de chaque élément).
Erreurs
Une erreur renvoie un statut HTTP et un corps JSON :
{ "error": { "code": "not_found", "message": "Article introuvable." } }400 · 404 · 429 · 500
Une idée de route, un besoin particulier ? Écris-nous sur le Discord d'OGHub.
Discord