Bulletins de rappels constructeurs

Opérations d'entretien et de maintenance recommandées par les constructeurs.

Liste

Pour obtenir la liste des bulletins de rappel pour un véhicule.

Requête

Recherche par immat

Endpoint

GET https://selene.api.centarauto.fr/getRappels?immat=IMMATRICULATION

Paramètres

Paramètre	Requis / Facultatif	Type	Description
immat	requis	string	N° d'immatriculation

Recherche par détails du véhicule

Endpoint

POST https://selene.api.centarauto.fr/getRappelsByDetails

Paramètres

Paramètre	Requis / Facultatif	Type	Description
immat	requis	string	N° d'immatriculation
vin	requis	string	Code vin
marque	requis	string	Marque
modele	requis	string	Modèle
version	facultatif	string	Version
codeMoteur	requis	string	Code moteur
puisKw	requis	integer	Puissance en kw
cylindree	requis	integer	Cylindrée
dateCircul	requis	string	Date de mise en circulation sous le format jj/mm/aaaa
energie	requis	enum	DIESEL / ESSENCE / AUTRE

Réponse

Paramètres

Paramètre	Type	Description
categoryDescription	string	Texte qui décrit la catégorie ("Rappels")
categoryTypeConstant	string	Identifiant unique de la catégorie ("RECALL")
systems	array	Une liste d'éléments contenant les détails des bulletins (cf. ci-après)

Le paramètre systems est un array d'objets contenant les paramètres suivants :

Paramètre	Type	Description
systemDescription	string	Texte décrivant le bulletin
systemId	integer	Identifiant du bulletin. Il permet notament d'obtenir des informartions supplémentaires sur le bulletin
oeCode	string	OE Code (peut être null)
issueDate	string	Date d'émission du bulletin sous le format "JJ/MM/AAAA" (peut être null)
criteria	array	Une liste d'objets, lorsqu'elle est présente (peut être null), indique les conditions selon lesquelles les données du bulletin s'appliquent (dates de construction, types de transmission, numéros VIN ou autres) (cf. ci-après)

Le paramètre criteria est une liste d'objets contenant les paramètres suivants :

Paramètre	Type	Description
values	array	Type Type key string Clé represenatant le critère d'application du bulletin value string Valeur du critère”

La liste des valeurs possibles pour le paramètre key :

Paramètre	Description
BODY_STYLE	this represents the body type of the car(forexample: “Estate”, “Hatchback” or“Mini-van”)
DAM_FROM	the start of aninterval of DAM codes(DAM means “Date Application Modification”,mainly used by Peugeot and Citroen)
DAM_TO	the end of a DAM codes interval
DATE_FROM	this is the start date (format: YYYY-MM; forexample 2010-06)
DATE_TO	this is the end date (same format)
ENGINE_FROM	the start of an interval of engines (forexample: 0020593)
ENGINE_TO	the end of an interval of engines (forexample: 0042724); they are not always both from and to present
VIN_FROM	the start of an interval of Vehicle Identification Numbers
VIN_TO	the end of a VIN interval
TRANSMISSION_TYPE	a language dependent text representing the type of transmission (for example“Automatic” or “Manual”)
TRANSMISSION_CODE	the code of a transmission (for example: iB5MTX-75, MMT6, AWF21)
TRANSMISSION_FROM	the start of a transmission codes interval
TRANSMISSION_TO	the end of atransmission codesin terval (forexample: DS450406576)

Exemple

Requête

const axios = require('axios').default;

// Remplacer ACCESS_TOKEN par celui obtenu suite à l'appel à "/auth"
const ACCESS_TOKEN = '';
const IMMAT =  'DL997DG';

const headers = {
  Authorization: 'Bearer ' + ACCESS_TOKEN,
  Content-Type: 'application/json'
};

const url = 'https://selene.api.centarauto.fr/getRappels?immat=' + IMMAT ;

// Send the POST request
axios({
  method: 'get',
  url,
  headers,
})
  .then((response) => response.data)
  .then((data) => {
    // Utiliser la réponse
    console.log('Data : ', data);
  })
  .catch((error) => {
    // Gérer l'erreur
    console.log('Error : ', error.response);
  });

Réponse

{
  "categoryDescription":"Rappels",
  "categoryTypeConstant":"RECALL",
  "systems":[
    {
      "systemDescription":"(Défaut de fabrication) L'appui-tête central arrière peut ne pas être conforme aux spécifications",
      "oeCode":"R/2019/066 (72I8)",
      "criteria":[
        {
          "values":[
            {
              "key":"VIN_FROM",
              "value":"WAUZZZ8V6J1068376"
            },
            {
              "key":"VIN_TO",
              "value":"WAUZZZ8V5J1090482"
            },
            {
              "key":"DATE_FROM",
              "value":"2018-04"
            },
            {
              "key":"DATE_TO",
              "value":"2018-06"
            }
          ]
        }
      ],
      "systemId":319016077,
      "issueDate":"27/02/2019"
    },
    {
      "systemDescription":"(Défaut de fabrication) L'appui-tête central arrière peut ne pas être conforme aux spécifications",
      "oeCode":"R/2019/066 (72I8)",
      "criteria":[
        {
          "values":[
            {
              "key":"VIN_FROM",
              "value":"WUAZZZ8V9J1906891"
            },
            {
              "key":"VIN_TO",
              "value":"WUAZZZ8V6J1908422"
            },
            {
              "key":"DATE_FROM",
              "value":"2018-04"
            },
            {
              "key":"DATE_TO",
              "value":"2018-06"
            }
          ]
        }
      ],
      "systemId":319016078,
      "issueDate":"27/02/2019"
    }
  ],
}

Détail

Pour obtenir le détail d'un bulletin de rappel.

Requête

Endpoint

GET https://selene.api.centarauto.fr/getRappelsData?systemId=SYSTEM_ID

Paramètres

Paramètre	Requis / Facultatif	Type	Description
systemId	requis	string	Identifiant du bulletin obtenu suite à un appel à "getRappels"

Réponse

Paramètres

Paramètre	Type	Description
groupDescription	string	Text qui représente la description du groupe (par exemple symptômes, solutions, pièces requises, ...)
bulletin	string	Liste d'objets qui contiennent les détails du bulletin (cf. ci-dessous)

Le paramètre bulletin est une liste d'objets contenant les paramètres suivants :

Paramètre	Type	Description
text	string	Texte contenant les données du bulletin
remark	string	Texte qui peut contenir (peut être null) des informations supplémentaires
image	string	Texte qui peut contenir (peut être null) une URL vers une image
EOBDCode	string	Texte qui peut contenir (peut être null) un code EOBD
OECode	string	Texte qui peut contenir (peut être null) un code OE
issueDate	string	Texte qui peut contenir (peut être null) la date d'émission du bulletin sous le format JJ/MM/AAAA
repairTime	integer	Nombre entier qui peut contenir (peut être null) le délai d'exécution de la réparation spécifiée. La valeur est un nombre avec 2 décimales dont le point décimal a été déplacé de 2 positions vers la droite (par exemple: 1,2 heure est représentée par 120; 1,2 h = 1 heure et 60 minutes * 0,2 = 1 heure et 12 minutes)
smartLinks	string	Non utilisé pour le moment, ce paramètre pourra être introduit dans les prochaines versions

Exemple

Requête

const axios = require('axios').default;

// Remplacer ACCESS_TOKEN par celui obtenu suite à l'appel à "/auth"
const ACCESS_TOKEN = '';
const SYSTEM_ID = '319016077'

const headers = {
  Authorization: 'Bearer ' + accessToken,
  'Content-Type': 'application/json'
};

const url = 'https://selene.api.centarauto.fr/getRappelsData?systemId=' + SYSTEM_ID;

// Send the POST request
axios({
  method: 'get',
  url,
  header
})
  .then((response) => response.data)
  .then((data) => {
    // Utiliser la réponse
    console.log('Data : ', data);
  })
  .catch((error) => {
    // Gérer l'erreur
    console.log('Error : ', error.response);
  });

Réponse

[
  {
    "groupDescription":"Défectueux",
    "bulletin":[
      {
        "text":"(Défaut de fabrication) L'appui-tête central arrière peut ne pas être conforme aux spécifications",
        "remark":null,
        "image":null,
        "repairTime":null,
        "smartLinks":null,
        "eobdcode":null,
        "oecode":null
      },
      {
        "text":"Nombre de véhicules affectés:",
        "remark":"1573",
        "image":null,
        "repairTime":null,
        "smartLinks":null,
        "eobdcode":null,
        "oecode":null
      }
    ]
  },
  {
    "groupDescription":"Solution",
    "bulletin":[
      {
        "text":"Contrôler l'appuie-tête ; remplacement si nécessaire",
        "remark":null,
        "image":null,
        "repairTime":null,
        "smartLinks":null,
        "eobdcode":null,
        "oecode":null
      }
    ]
  },
  {
    "groupDescription":"Limitation de responsabilité",
    "bulletin":[
      {
        "text":"Les bulletins de rappel sont fournis à titre d'information uniquement.",
        "remark":null,
        "image":null,
        "repairTime":null,
        "smartLinks":null,
        "eobdcode":null,
        "oecode":null
      },
      {
        "text":"Le client doit être dirigé vers le revendeur franchisé compétent pour corriger les problèmes identifiés dans la notice Rappel de sécurité.",
        "remark":null,
        "image":null,
        "repairTime":null,
        "smartLinks":null,
        "eobdcode":null,
        "oecode":null
      },
      {
        "text":"Ceci garantit l'exécution de la réparation entièrement en conformité avec les dispositions de la notice Rappel de sécurité et avec toutes celles qui y ont été mises à jour.",
        "remark":null,
        "image":null,
        "repairTime":null,
        "smartLinks":null,
        "eobdcode":null,
        "oecode":null
      },
      {
        "text":"",
        "remark":null,
        "image":null,
        "repairTime":null,
        "smartLinks":null,
        "eobdcode":null,
        "oecode":null
      },
      {
        "text":"Ceci garantira que la base de données du fabricant (la liste des véhicules concernés) et l'agence d'émission de licences spécifique au pays ont étés toutes deux informées de la mise en action du rappel.",
        "remark":null,
        "image":null,
        "repairTime":null,
        "smartLinks":null,
        "eobdcode":null,
        "oecode":null
      }
    ]
  }
]