Introduction et prerequis
Ce guide explique, etape par etape, comment deployer un site statique (ou SSR) qui consomme les APIs publiques de ZodBack. Il s'adresse a tout developpeur souhaitant creer un nouveau site externe — blog, portfolio, documentation, e-commerce vitrine, etc.
Ce que couvre ce guide
- Creer un token API avec les bonnes permissions
- Configurer le site (headers, fetch, cache)
- Comprendre le CORS et les origines autorisees
- Modifier la matrice d'autorisation (si necessaire)
- Deployer sur Cloudflare Workers ou Vercel
- Tester et verifier de bout en bout
Prerequis
Avant de commencer, assurez-vous d'avoir :
| Element | Detail |
|---|---|
| Compte ZodBack | Un compte administrateur sur le dashboard (app.zoddev.site) |
| Projet cree | Au moins un projet actif dans le dashboard |
| Module active | Le ou les modules que votre site va consommer (blog, portfolio, documentation, etc.) |
| Donnees seedees | Du contenu publie dans le module (posts, projets, pages docs, etc.) |
| Domaine | Un domaine ou sous-domaine pour votre site (ex: mon-site.zoddev.site) |
Workflow global
1. Dashboard : creer un token API
|
2. Code : configurer config.js + api.js
|
3. Backend : verifier CORS + matrice (si nouveau module)
|
4. Deploy : Cloudflare Workers ou Vercel
|
5. Test : curl + navigateur + DevTools
Modules disponibles en API publique
Les modules suivants exposent des endpoints publics consommables par des sites externes :
| Module | Prefix API | Entite token |
|---|---|---|
| Blog | /api/blog/v1/public |
blog |
| Portfolio | /api/portfolio/v1/public |
portfolio |
| Documentation | /api/docs/v1/public |
documentation |
Note : Si vous souhaitez exposer un autre module, il faudra ajouter des endpoints publics et les declarer dans la matrice d'autorisation (voir page 5).