API Développeurs v1.1
L'API d'ArkunirMC Archives permet aux développeurs de la communauté d'intégrer les données historiques du wiki dans leurs propres outils (bots Discord, dashboards, sites de clans).
Accès
Lecture seule (Public)
Auth
Aucune clé requise
Speed
Rate Limit : 120 req/min
GET
https://arkunirmc-archives.lunekkowo.fr/api/v1/articles
Liste des articles
Récupère la liste paginée de tous les articles officiellement publiés sur le wiki.
Paramètres Query
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
page | integer | 1 | Numéro de la page à récupérer. |
limit | integer | 20 | Nombre d'articles par page (max 100). |
tag | string | - | Filtre les articles par tag (ex: guerre). |
Exemple de réponse
{
"status": "success",
"total": 42,
"page": 1,
"limit": 20,
"results": [
{
"title": "La Bataille du Sud",
"slug": "bataille-du-sud",
"tags": "guerre, historique",
"views": 1024,
"created_at": "2024-03-24 12:00:00",
"updated_at": "2024-03-24 15:30:00",
"author": "Lunekkowo",
"thumbnail_url": "https://arkunirmc-archives.lunekkowo.fr/uploads/hero.jpg"
}
]
}
GET
https://arkunirmc-archives.lunekkowo.fr/api/v1/article?slug={slug}
Détails d'un article
Récupère toutes les données d'un seul article, y compris son contenu HTML rendu.
Paramètres Query
| Paramètre | Type | Requis | Description |
|---|---|---|---|
slug | string | Oui | Le slug URL de la page (ex: bataille-du-sud). |
Structure de réponse
title: Titre complet de l'article.content_html: Corps de l'article au format HTML.is_skin: Booléen indiquant si le thumbnail est un pseudo Minecraft (Skin 3D).author: Nom d'affichage de l'auteur original.
Exemple d'intégration JS
fetch('https://arkunirmc-archives.lunekkowo.fr/api/v1/article?slug=ma-page')
.then(res => res.json())
.then(json => {
document.title = json.data.title;
document.getElementById('content').innerHTML = json.data.content_html;
});
GET
https://arkunirmc-archives.lunekkowo.fr/api/v1/search?q={query}
Recherche Publique
Recherche par mots-clés dans les titres, les tags et le contenu des articles.
Paramètres Query
| Paramètre | Type | Requis | Description |
|---|---|---|---|
q | string | Oui | Terme de recherche (min 2 caractères). |
GET
https://arkunirmc-archives.lunekkowo.fr/api/v1/stats
Statistiques globales
Nombre total de pages, de médias et de vues cumulées sur l'ensemble du wiki.
Besoin d'aide supplémentaire ? Contactez-nous à lunekkowo@gmail.com.