Skip to main content

​
Administrer le blog

Les admins rédigent, publient et modèrent les articles du blog public wethehivers.com/blog.

​
Flow global

​
1. Créer un article (DRAFT)

POST /v1/api/admin/blog HTTP/1.1
Authorization: Bearer <ADMIN_TOKEN>
Content-Type: application/json

{
  "titre": "Réussir son entretien Backend Java au Cameroun",
  "resume": "5 conseils d'experts pour briller en entretien...",
  "contenu": "# Introduction\n\nLe marché Java...",
  "categorieId": 3,
  "tags": ["entretien", "java", "backend"],
  "metaTitle": "Entretien Backend Java Cameroun : 5 conseils — THE HIVE",
  "metaDescription": "Comment préparer votre entretien backend..."
}
Réponse 201 : 
{
  "id": 14,
  "slug": "reussir-entretien-backend-java-cameroun",
  "status": "DRAFT",
  "createdAt": "2026-04-18T10:00:00Z"
}

​
2. Upload de la cover

POST /v1/api/admin/blog/14/cover HTTP/1.1
Content-Type: multipart/form-data

file=@cover.jpg

​
3. Éditer en markdown

Le champ contenu accepte du markdown rendu via remark-gfm. Supporte :
  • Titres #, ##, ###
  • Listes, tableaux, citations
  • Liens et images (chemin R2 ou URL externe whitelistée)
  • Code blocks avec syntax highlighting
  • Embeds YouTube / Twitter via shortcodes
![Figure 1 : flow recrutement](cover:1200)

:::info
Astuce : préparez 3 projets concrets à raconter.
:::

| Étape | Durée |
|-------|-------|
| Test technique | 1h30 |
| Entretien RH | 30 min |

​
4. Publier

POST /v1/api/admin/blog/14/publish HTTP/1.1

​
Validations à la publication

​
5. Dépublier / archiver

POST /v1/api/admin/blog/14/unpublish  → retour DRAFT
POST /v1/api/admin/blog/14/archive     → ARCHIVED (hors nav, slug libéré)

​
6. Modération des commentaires

GET /v1/api/admin/blog/commentaires?status=PENDING

PATCH /v1/api/admin/blog/commentaires/88 { "status": "APPROVED" }

​
Auto-modération

​
7. Catégories & tags

GET /v1/api/admin/blog/categories
POST /v1/api/admin/blog/categories { "nom": "Tech", "slug": "tech", "couleur": "#264194" }
Les tags sont libres (créés à la volée à la sauvegarde). Les catégories sont contrôlées.

​
8. Analytics par article

GET /v1/api/admin/blog/14/analytics

{
  "vuesTotal": 1452,
  "vuesDernieres30j": 312,
  "tempsLectureMoyen": 4.2,
  "tauxSortie": 0.42,
  "commentaires": 8,
  "partages": 24
}

​
9. SEO & sitemap

​
Meta-tags générés

<title>Entretien Backend Java Cameroun : 5 conseils — THE HIVE</title>
<meta name="description" content="Comment préparer...">
<meta property="og:image" content="https://cdn.wethehivers.com/public/blog/14/cover.webp">
<meta property="og:type" content="article">
<meta name="twitter:card" content="summary_large_image">
<script type="application/ld+json">{"@context":"https://schema.org","@type":"Article",...}</script>

​
10. Prévisualisation

Chaque DRAFT est accessible via URL privée authentifiée : 
GET /v1/api/admin/blog/14/preview
→ 200 HTML rendu identique au public

​
Rôles

ActionADMINSUPER_ADMIN
Créer / éditer article✓✓
Publier / dépublier✓✓
Modérer commentaires✓✓
Gérer catégories✗✓
Supprimer définitivement article archivé✗✓

​
Voir aussi