API Boosts

Objectif

Consulter le catalogue de boosts et acheter/activer des boosts pour un acteur.

Périmètre

Visibilité, diffusion locale, notifications, IA supplémentaire ou options premium à confirmer.

Acteurs/applications consommatrices

• DMV acteur.
• Backoffice.
• PlayLoop ou Mairie en cible selon offres.

Authentification requise

• Catalogue : public avec X-App-Source.
• Liste et achat acteur : auth:sanctum.

Permissions/RBAC

• Achat réservé aux gestionnaires autorisés.
• Effets du boost appliqués côté Laravel.
• Les boosts ne contournent pas la modération.

Endpoints actuels visibles si confirmés

Méthode	Route	Statut
GET	/api/v1/boosts/catalog	Confirmé.
GET	/api/v1/acteurs/{id}/boosts	Confirmé.
POST	/api/v1/acteurs/{id}/boosts	Confirmé.

Endpoints cibles proposés si utile

• PATCH /api/v1/boosts/{id}/cancel à confirmer si annulation supportée.

Exemple de requête

POST /api/v1/acteurs/acteur-id/boosts
Authorization: Bearer <token>
X-App-Source: dmv
Content-Type: application/json

{
  "boost_type": "visibility",
  "target_id": "publication-id"
}

Exemple de réponse succès

{
  "data": {
    "id": "boost-id",
    "status": "active",
    "expires_at": "2026-05-17T10:00:00Z"
  }
}

Exemple d’erreur

{
  "error": "boost_not_allowed",
  "message": "Ce boost n’est pas disponible pour cette cible."
}

Pagination si applicable

Applicable à la liste des boosts acteur.

Rate limiting si applicable

Recommandé sur achats et activations.

Audit/logs si applicable

Obligatoire pour achat, activation, expiration et actions liées aux notifications.

Sécurité

• Vérification paiement et droits côté Laravel.
• Limites anti-spam sur boosts de notification.
• Coûts IA plafonnés si boost IA.

État actuel vs cible

Sujet	État actuel	Cible
Catalogue/achat	Routes visibles.	Types et effets documentés.
IA boostée	Vision business.	Quotas/crédits reliés aux boosts.

Points à confirmer

• Types de boosts.
• Cibles autorisées.
• Durées et cumul.
• Annulation/remboursement.