Aller au contenu principal

API

Cette page récapitule les API exposées par l'application Logistique. Pour chaque endpoint vous trouverez :

  • la méthode HTTP
  • l'URL
  • les paramètres attendus
  • un exemple de requête
  • un exemple de réponse

Stocks​

GET /api/publique/stocks​

Récupère la liste des stocks.

Pas de param requis

Exemple :

GET /stocks HTTP/1.1
Host: localhost:3000

Response 200 liste d'items stock

GET /api/publique/stocks/:id​

Récupère le stock d'un produit ou d'un warehouse en particulier.

Query params:

  • stockId : filtre par référence produit

Exemple :

GET /stocks?stockId=69 HTTP/1.1
Host: localhost:3000

Response 200

[
  {
    "stock": 69,
    "id": 69,
    ...
  }
]

Fiches de réparation​

POST /api/publique/fiche_reparation​

Créer une fiche de réparation

Body (JSON):

{
  "idClient": "CLI-69",
  "idProduit": "PROD-69",
  "ticketId": "TICKET-69",
  "motif": "Défaut d’affichage sur écran",
  "origine": "ecommerce",
  "adresseClient": "69 Rue de Lyon, 69001 Lyon, France"
}

Response 201

GET /api/publique/fiche_reparation​

Récupère la liste des fiches de réparation

  • Params : aucun
  • Body : aucun
  • Response 200
  • Retourne liste des fiches

GET /api/publique/fiche_reparation/:id​

Récupère une fiche précise et son contexte logistique

  • Params : id
  • Body : aucun
  • Response : fiche (ou 404)

GET /api/publique/bordereau​

Liste les bordereaux enregistrés pour le SAV

  • Params : aucun
  • Body : aucun
  • Response : liste des bordereaux

Events SAV​

POST /api/publique/events_reparation​

Endpoint pour envoyer l'avancement de la réparation à l'application SAV.

  • Params : aucun
  • Body : EventReparationDataDto
{
  "ticketId": "TICKET-69",
  "event": "ARRIVE_DEPOT",
  "at": "2025-10-23T09:30:00Z"
}

Valeurs autorisées pour event (enum) :

  • "ARRIVE_DEPOT"
  • "EN_REPARATION"
  • "REPARATION_OK"
  • "EXPEDIE_CLIENT"