Aller au contenu principal
APIPlaque

API plaque avec cURL : requête et statut HTTP

Construisez une requête cURL vers l’API plaque France avec les en-têtes RapidAPI et un paramètre plaque encodé.

Publié le

cURL permet de vérifier la construction d’une requête à l’API plaque depuis un terminal. Il affiche ici le corps reçu puis le statut HTTP, tout en limitant la durée de l’appel.

Préparer le terminal

L’exemple vise Bash ou un shell POSIX et cURL 7.76 ou ultérieur pour --fail-with-body. Chargez les variables dans l’environnement sans écrire votre clé réelle dans une commande partagée. Confirmez la base et le host depuis la console RapidAPI : l’adresse du catalogue en .p.rapidapi.co reste à vérifier.

Requête

Variables du serveur
# Configuration serveur uniquement. Confirmer URL et hôte dans RapidAPI.
RAPIDAPI_KEY=YOUR_RAPIDAPI_KEY
API_PLAQUE_BASE_URL=https://api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co
RAPIDAPI_HOST=api-plaque-immatriculation-france-donnees-vehicule-siv.p.rapidapi.co
Terminal Bash / POSIX — curl 7.76 ou ultérieur
# Charger les variables ci-dessus dans l'environnement du terminal.
: "${RAPIDAPI_KEY:?Définir RAPIDAPI_KEY}"
: "${API_PLAQUE_BASE_URL:?Confirmer la base URL dans RapidAPI}"
: "${RAPIDAPI_HOST:?Confirmer le host dans RapidAPI}"
curl --silent --show-error --fail-with-body \
  --connect-timeout 5 --max-time 10 \
  --request GET --get \
  --url "${API_PLAQUE_BASE_URL%/}/fr" \
  --header "x-rapidapi-key: $RAPIDAPI_KEY" \
  --header "x-rapidapi-host: $RAPIDAPI_HOST" \
  --header "Content-Type: application/json" \
  --data-urlencode 'plaque=FH034DD' \
  --write-out '\nHTTP %{http_code}\n'

Interpréter le résultat

L’unique exemple de réponse fournisseur publié est HTTP 200 avec une enveloppe JSON de succès. Un résultat HTTP en erreur doit être inspecté sans supposer que son corps a ce même format. --fail-with-body donne un code de sortie d’échec pour les erreurs HTTP concernées et conserve le corps pour diagnostic. Cette commande ne décode pas le JSON et ne détecte pas une erreur métier dans une réponse HTTP 200.

La ligne HTTP ajoutée sert au diagnostic ; retirez --write-out si vous envoyez le corps à un parseur JSON. Ne partagez pas de sortie contenant une clé ou des données véhicule inutiles au diagnostic.

Pour traiter les données dans une application, passez aux exemples d’intégration. Consultez le format de réponse et les cas d’erreur à vérifier.

Référence technique : manuel cURL.

Consulter l’API sur RapidAPILire la documentation