Cette page recense les contrats API à documenter pour maintenir la documentation chatbot alignée avec les évolutions backend, Logidav et UI.
Ordre de source de vérité
- Code mergé et contrats backend actifs.
- Docs internes backend versionnées.
- Comportement Logidav actuellement déployé.
- UI chatbot visible par le client.
- Ticket produit ou validation métier.
Si deux sources divergent, la page doit mentionner le point à valider au lieu de figer une règle incertaine.
SAV
| Sujet | Endpoint ou contrat | Statut documentation |
|---|
| Création SAV | POST /api/v2/sav/requests | À détailler par type SAV. |
| Bon d'achat remboursement +40% | Type SAV refund-voucher | Intégré au guide Relance remboursement, contrat API à compléter. |
| Relances SLA | POST /api/v2/sav/validations/reminder-sla | À documenter avec matrice délais / limites. |
| Oubli code promo | /api/v2/sav/forgotten-coupon/eligibility, /api/v2/sav/forgotten-coupon/ticket | À documenter. |
| Notifications erreurs SAV | POST /api/v2/sav/error-notifications | À documenter avec catalogue erreurs. |
Commandes
| Sujet | Endpoint ou contrat | Statut documentation |
|---|
| Éligibilité annulation | GET /api/v2/orders/{reference}/cancellation-eligibility | À documenter. |
| État support commande | GET /api/v2/orders/{reference}/support-state | À documenter. |
| État réexpédition | GET /api/v2/orders/{reference}/reshipment-state | À documenter. |
| Éligibilité pièce manquante | POST /api/v2/orders/{reference}/missing-part-eligibility | À documenter. |
Livraison
| Sujet | Endpoint ou contrat | Statut documentation |
|---|
| Options de livraison | /v2/delivery/options | À documenter. |
| Changement de méthode | /v2/delivery/change | À documenter. |
| Statut paiement changement livraison | /v2/delivery/payment-status/{changeId} | À documenter. |
| Mise à jour données livraison | update-shipment-details / delivery-info-update | À valider avant documentation définitive. |
Client
| Sujet | Endpoint ou contrat | Statut documentation |
|---|
| Mise à jour email | POST /api/v2/customers/email-update/initiate, POST /api/v2/customers/email-update/verify | À documenter. |
Critères attendus pour chaque endpoint
Chaque contrat API ajouté doit préciser :
- l'objectif métier,
- les permissions ou scopes requis,
- les paramètres d'entrée,
- les réponses nominales,
- les erreurs fonctionnelles,
- les erreurs techniques,
- les règles de test ou suffixes de référence si applicables,
- l'impact côté chatbot, backend et Logidav.