/api/v1/projects/{ref}/reportsPréparer un rapport
Prépare le rapport d'une période avec le mot de l'agence ; il peut être publié et envoyé au client par mail.
Prépare le rapport d'une période : Tetikasa en calcule les chiffres, vous y
ajoutez ce qui a été fait (summary) et ce qui vient (next_steps). Un seul
rapport par période — rappeler la route avec les mêmes dates reprend le même
et met son texte à jour.
Le rapport reste un brouillon que l'agence relit depuis l'onglet Résultats
du projet. Avec publish: true, il est publié : ses chiffres sont figés, il
s'affiche dans la page Résultats du portail et part par mail au client, et
aux destinataires ajoutés dans les réglages d'envoi de l'onglet Rapports.
GET sur la même route liste les rapports du projet, du plus récent au plus
ancien.
Paramètres de chemin
| Paramètre | Description |
|---|---|
ref | L'id ou le slug du projet |
Corps de la requête
| Champ | Type | Requis | Contraintes |
|---|---|---|---|
period_start | string | oui | Premier jour, YYYY-MM-DD |
period_end | string | oui | Dernier jour inclus, YYYY-MM-DD |
summary | string | Ce qui a été fait et ce qui a marché, 5 000 caractères max | |
next_steps | string | Les prochaines actions, 5 000 caractères max | |
publish | boolean | false par défaut ; true publie et envoie le mail |
Cette route accepte un en-tête Idempotency-Key.
Exemple
curl -X POST "https://www.tetikasa.app/api/v1/projects/campagne-meta-raphael/reports" \
-H "Authorization: Bearer $TETIKASA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"period_start":"2026-10-19","period_end":"2026-10-25",
"summary":"Campagne relancée : le coût par contact baisse de 18 %.",
"next_steps":"Tester une nouvelle accroche vidéo."}'La réponse vaut 201 quand le rapport est créé, 200 quand il existait déjà
pour cette période.
Erreurs
code | Statut | Quand |
|---|---|---|
invalid_request | 422 | Corps invalide, ou period_start après period_end |
forbidden | 403 | Le reporting est inclus dans les plans payants |
not_found | 404 | Projet inexistant ou d'une autre organisation |
unauthorized | 401 | Clé absente, invalide, révoquée ou expirée |
