Documentation de l'API Manutest

Reference developpeur de l'API v1 pour consulter les clients, vehicules, loueurs et appareils associes.

Introduction

L'API Manutest expose des routes HTTP en lecture sous /api/v1. Les routes metier retournent des donnees JSON et utilisent un format homogene pour les listes paginees.

Base URL

https://api-manutest.sipco.fr/api/v1

Version

Format

JSON

Methodes exposees

GET

https://api-manutest.sipco.fr/api/v1

Authentification

Toutes les routes sauf /health exigent une cle API transmise dans l'en-tete x-api-key.

x-api-key: VOTRE_CLE_API

En l'absence de cle valide, l'API renvoie une reponse 401 Unauthorized.

Pour obtenir une cle API, contactez SIPCO : 02 99 76 16 16.

Pagination

Les endpoints listant des ressources utilisent une pagination limit / offset. Parcourez les pages jusqu'a ce que pagination.nextOffset soit null.

Champ	Type	Description
`limit`	number	Nombre maximum d'éléments retournés. Défaut 50, maximum 200.
`offset`	number	Index de départ. Utiliser 0 pour commencer au debut de la liste.
`count`	number	Nombre d'éléments retournés dans la page courante.
`total`	number	Nombre total d'éléments disponibles pour la requête.
`hasMore`	boolean	Indique s'il reste au moins une page a lire.
`nextOffset`	number \| null	Offset à utiliser pour la page suivante, ou null en fin de liste.

{
  "data": [],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "count": 100,
    "total": 8437,
    "hasMore": true,
    "nextOffset": 100
  }
}

/api/v1/health

GET/api/v1/healthAuth: Non

Endpoint de sante public permettant de verifier que l'API repond.

Parametres

Nom	Type	Description
`Aucun`	-	Cette route ne prend aucun parametre.

Exemple curl

curl -X GET "https://api-manutest.sipco.fr/api/v1/health"

Exemple JSON

{
  "ok": true,
  "ts": "2026-05-06T12:00:00.000Z"
}

Champs retournes

Champ	Description
`ok`	Etat de disponibilite de l'API.
`ts`	Horodatage ISO genere par le serveur.

/api/v1/clients

GET/api/v1/clientsAuth: Oui

Retourne la liste des clients / transporteurs rattaches au prestataire courant.

trptel correspond au telephone client. trpcontact correspond au contact ou nom du contact.

Parametres

Nom	Type	Description
`limit`	number	Optionnel. Defaut 50, maximum 200.
`offset`	number	Optionnel. Defaut 0.

Exemple curl

curl -X GET "https://api-manutest.sipco.fr/api/v1/clients?limit=50&offset=0" \
  -H "x-api-key: VOTRE_CLE_API"

Exemple JSON

{
  "data": [
    {
      "trpid": 1,
      "trpnom": "Dupont SARL",
      "trpadr": "12 rue des Ateliers",
      "trpcp": "35000",
      "trpville": "Rennes",
      "trptel": "02 99 00 00 00",
      "trpmail": "contact@dupont.fr",
      "trpcontact": "Jean Dupont",
      "trpderrel": null,
      "trpenvrap": 1,
      "trpenvrel": 1,
      "trpsommeil": 0,
      "trpinconnu": 0
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 128,
    "hasMore": true,
    "nextOffset": 50
  }
}

Champs retournes

Champ	Description
`trpid`	Identifiant du client / transporteur.
`trpnom`	Nom du client / transporteur.
`trpadr`	Adresse.
`trpcp`	Code postal.
`trpville`	Ville.
`trptel`	Téléphone client.
`trpmail`	Email client.
`trpcontact`	Contact / nom du contact client.
`trpderrel`	Dernière relance connue.
`trpenvrap`	Indicateur d'envoi de rapport.
`trpenvrel`	Indicateur d'envoi de relance.
`trpsommeil`	Indicateur de sommeil.
`trpinconnu`	Indicateur client inconnu.

/api/v1/vehicles

GET/api/v1/vehiclesAuth: Oui

Retourne les vehicules clients rattaches au prestataire courant.

Les champs retournes ici concernent le vehicule lui-meme : immatriculation, parc, chassis, marque, modele et autres colonnes de manutest.vehicules. Les appareils associes se consultent via GET /api/v1/vehicles/:id/equipments.

Parametres

Nom	Type	Description
`limit`	number	Optionnel. Defaut 50, maximum 200.
`offset`	number	Optionnel. Defaut 0.

Exemple curl

curl -X GET "https://api-manutest.sipco.fr/api/v1/vehicles?limit=50&offset=0" \
  -H "x-api-key: VOTRE_CLE_API"

Exemple JSON

{
  "data": [
    {
      "vehid": 246636,
      "vehimmat": "AB-123-CD",
      "vehparc": "PARC-42",
      "vehtransp": 1,
      "vehloueur": null,
      "vehmarq": 304,
      "vehmarqlib": "RENAULT",
      "vehmodel": "MASTER",
      "vehcat": 4
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 8437,
    "hasMore": true,
    "nextOffset": 50
  }
}

Champs retournes

Champ	Description
`vehid`	Identifiant du véhicule.
`vehimmat`	Immatriculation du véhicule.
`vehparc`	Référence parc du véhicule, si présente.
`vehchassis`	Chassis / numero de chassis, si présent dans la table véhicules.
`vehmarq`	Identifiant de marque du véhicule.
`vehmarqlib`	Libellé de marque du véhicule, issu de manutest.marques avec marqtype = 0.
`vehmodel`	Modele du véhicule.
`vehtransp`	Identifiant transporteur associe, si véhicule client.
`vehloueur`	Identifiant loueur associe, si véhicule loueur.
`v.*`	Les routes véhicules retournent toutes les colonnes de manutest.vehicules, plus vehmarqlib.

/api/v1/transp/:id/vehicles

GET/api/v1/transp/:id/vehiclesAuth: Oui

Retourne les vehicules d'un client / transporteur, apres verification qu'il appartient au prestataire courant.

Parametres

Nom	Type	Description
`id`	number	Identifiant du client / transporteur.
`limit`	number	Optionnel. Defaut 50, maximum 200.
`offset`	number	Optionnel. Defaut 0.

Exemple curl

curl -X GET "https://api-manutest.sipco.fr/api/v1/transp/1/vehicles?limit=50&offset=0" \
  -H "x-api-key: VOTRE_CLE_API"

Exemple JSON

{
  "data": [
    {
      "vehid": 246636,
      "vehimmat": "AB-123-CD",
      "vehparc": "PARC-42",
      "vehtransp": 1,
      "vehloueur": null,
      "vehmarq": 304,
      "vehmarqlib": "RENAULT",
      "vehmodel": "MASTER",
      "vehcat": 4
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 8437,
    "hasMore": true,
    "nextOffset": 50
  }
}

Champs retournes

Champ	Description
`vehid`	Identifiant du véhicule.
`vehimmat`	Immatriculation du véhicule.
`vehparc`	Référence parc du véhicule, si présente.
`vehchassis`	Chassis / numero de chassis, si présent dans la table véhicules.
`vehmarq`	Identifiant de marque du véhicule.
`vehmarqlib`	Libellé de marque du véhicule, issu de manutest.marques avec marqtype = 0.
`vehmodel`	Modele du véhicule.
`vehtransp`	Identifiant transporteur associe, si véhicule client.
`vehloueur`	Identifiant loueur associe, si véhicule loueur.
`v.*`	Les routes véhicules retournent toutes les colonnes de manutest.vehicules, plus vehmarqlib.

/api/v1/loueurs

GET/api/v1/loueursAuth: Oui

Retourne la liste des loueurs rattaches au prestataire courant.

Parametres

Nom	Type	Description
`limit`	number	Optionnel. Defaut 50, maximum 200.
`offset`	number	Optionnel. Defaut 0.

Exemple curl

curl -X GET "https://api-manutest.sipco.fr/api/v1/loueurs?limit=50&offset=0" \
  -H "x-api-key: VOTRE_CLE_API"

Exemple JSON

{
  "data": [
    {
      "louid": 10,
      "lounom": "Location Ouest",
      "louadr": "4 avenue du Parc",
      "loucp": "44000",
      "louville": "Nantes",
      "loutel": "02 40 00 00 00",
      "loumail": "contact@location-ouest.fr",
      "loucontact": "Marie Martin",
      "louderrel": null,
      "louenvrap": 1,
      "louenvrel": 1,
      "loufreq": 12
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 24,
    "hasMore": false,
    "nextOffset": null
  }
}

Champs retournes

Champ	Description
`louid`	Identifiant du loueur.
`lounom`	Nom du loueur.
`louadr`	Adresse.
`loucp`	Code postal.
`louville`	Ville.
`loutel`	Téléphone du loueur.
`loumail`	Email du loueur.
`loucontact`	Contact / nom du contact loueur.
`louderrel`	Dernière relance connue.
`louenvrap`	Indicateur d'envoi de rapport.
`louenvrel`	Indicateur d'envoi de relance.
`loufreq`	Fréquence associée au loueur.

/api/v1/loueurs/vehicles

GET/api/v1/loueurs/vehiclesAuth: Oui

Retourne tous les vehicules des loueurs rattaches au prestataire courant.

Parametres

Nom	Type	Description
`limit`	number	Optionnel. Defaut 50, maximum 200.
`offset`	number	Optionnel. Defaut 0.

Exemple curl

curl -X GET "https://api-manutest.sipco.fr/api/v1/loueurs/vehicles?limit=50&offset=0" \
  -H "x-api-key: VOTRE_CLE_API"

Exemple JSON

{
  "data": [
    {
      "vehid": 246636,
      "vehimmat": "AB-123-CD",
      "vehparc": "PARC-42",
      "vehtransp": 10,
      "vehloueur": null,
      "vehmarq": 304,
      "vehmarqlib": "RENAULT",
      "vehmodel": "MASTER",
      "vehcat": 4
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 8437,
    "hasMore": true,
    "nextOffset": 50
  }
}

Champs retournes

Champ	Description
`vehid`	Identifiant du véhicule.
`vehimmat`	Immatriculation du véhicule.
`vehparc`	Référence parc du véhicule, si présente.
`vehchassis`	Chassis / numero de chassis, si présent dans la table véhicules.
`vehmarq`	Identifiant de marque du véhicule.
`vehmarqlib`	Libellé de marque du véhicule, issu de manutest.marques avec marqtype = 0.
`vehmodel`	Modele du véhicule.
`vehtransp`	Identifiant transporteur associe, si véhicule client.
`vehloueur`	Identifiant loueur associe, si véhicule loueur.
`v.*`	Les routes véhicules retournent toutes les colonnes de manutest.vehicules, plus vehmarqlib.

/api/v1/loueurs/:id/vehicles

GET/api/v1/loueurs/:id/vehiclesAuth: Oui

Retourne les vehicules d'un loueur, apres verification qu'il appartient au prestataire courant.

Parametres

Nom	Type	Description
`id`	number	Identifiant du loueur.
`limit`	number	Optionnel. Defaut 50, maximum 200.
`offset`	number	Optionnel. Defaut 0.

Exemple curl

curl -X GET "https://api-manutest.sipco.fr/api/v1/loueurs/10/vehicles?limit=50&offset=0" \
  -H "x-api-key: VOTRE_CLE_API"

Exemple JSON

{
  "data": [
    {
      "vehid": 246636,
      "vehimmat": "AB-123-CD",
      "vehparc": "PARC-42",
      "vehtransp": 10,
      "vehloueur": null,
      "vehmarq": 304,
      "vehmarqlib": "RENAULT",
      "vehmodel": "MASTER",
      "vehcat": 4
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 8437,
    "hasMore": true,
    "nextOffset": 50
  }
}

Champs retournes

Champ	Description
`vehid`	Identifiant du véhicule.
`vehimmat`	Immatriculation du véhicule.
`vehparc`	Référence parc du véhicule, si présente.
`vehchassis`	Chassis / numero de chassis, si présent dans la table véhicules.
`vehmarq`	Identifiant de marque du véhicule.
`vehmarqlib`	Libellé de marque du véhicule, issu de manutest.marques avec marqtype = 0.
`vehmodel`	Modele du véhicule.
`vehtransp`	Identifiant transporteur associe, si véhicule client.
`vehloueur`	Identifiant loueur associe, si véhicule loueur.
`v.*`	Les routes véhicules retournent toutes les colonnes de manutest.vehicules, plus vehmarqlib.

/api/v1/vehicles/:id/equipments

GET/api/v1/vehicles/:id/equipmentsAuth: Oui

Retourne les appareils associes a un vehicule, apres verification que le vehicule appartient au prestataire courant via son transporteur ou son loueur.

Parametres

Nom	Type	Description
`id`	number	Identifiant du vehicule.
`limit`	number	Optionnel. Defaut 50, maximum 200.
`offset`	number	Optionnel. Defaut 0.

Exemple curl

curl -X GET "https://api-manutest.sipco.fr/api/v1/vehicles/246636/equipments?limit=50&offset=0" \
  -H "x-api-key: VOTRE_CLE_API"

Exemple JSON

{
  "data": [
    {
      "matid": 12,
      "matveh": 246636,
      "matser": "SN123456",
      "matdesc": "Chronotachygraphe",
      "matannee": 2023,
      "matmarquage": null,
      "matrelance": null,
      "matsommeil": 0,
      "matdate": null,
      "matmarq": 15,
      "matmarqlib": "STONERIDGE",
      "matmodel": "SE5000",
      "matcomm": null,
      "matderrel": null,
      "matphoto": null
    }
  ],
  "pagination": {
    "limit": 50,
    "offset": 0,
    "count": 1,
    "total": 1,
    "hasMore": false,
    "nextOffset": null
  }
}

Champs retournes

Champ	Description
`matid`	Identifiant de l'appareil.
`matveh`	Identifiant du véhicule associé.
`matser`	Numéro de série de l'appareil.
`matdesc`	Description de l'appareil.
`matannee`	Année de l'appareil.
`matmarquage`	Marquage de l'appareil.
`matrelance`	Indicateur ou date de relance selon la donnée source.
`matsommeil`	Indicateur de sommeil.
`matdate`	Date associée à l'appareil.
`matmarq`	Identifiant de marque appareil.
`matmarqlib`	Libellé de marque appareil.
`matmodel`	Modèle de l'appareil.
`matcomm`	Commentaire.
`matderrel`	Dernière relance connue.
`matphoto`	Référence photo, si présente.

Codes de reponse

Code	Signification	Description
`200`	OK	Requete reussie.
`400`	Bad Request	Parametre invalide, par exemple un id non numerique.
`401`	Unauthorized	Cle API absente ou incorrecte.
`404`	Not Found	Ressource introuvable ou hors perimetre du prestataire courant.
`500`	Server Error	Erreur interne du serveur. Contacter SIPCO si elle persiste.