API Blog — Introduction

Cette documentation décrit l’API publique du module Blog utilisée par le site externe z-blog.

Base URL

• Production: https://api.zoddev.site/api/blog/v1/public
• Dev (local): http://localhost:3013/api/blog/v1/public

Auth & headers requis

Le token API peut être fourni via:

• x-api-key: <TOKEN> (prioritaire)
• Authorization: Bearer <TOKEN> (fallback)

Le contexte projet est résolu via le token. Si vous utilisez un token global, ajoutez aussi:

• X-Project-Id: 1

En production, l’API attend un header Origin sur les requêtes navigateur (CORS). Sans Origin, la réponse peut être:

{ "error": "CORS: origin header required in production" }

Exemple cURL (recommandé pour valider)

curl -s "https://api.zoddev.site/api/blog/v1/public/posts" \
  -H "x-api-key: <TOKEN>" \
  -H "X-Project-Id: 1" \
  -H "Origin: https://blog.zoddev.site"

Format de réponse

Les endpoints publics répondent généralement:

{ "success": true, "data": ... }