Documentation · Guide d'intégration

Configuration de l'API AutoScout24

Ce document explique comment l'accès à l'API AutoScout24 s'intègre dans l'extension ADP Car Market Hub, de quels identifiants l'extension a besoin et comment un administrateur peut valider que le compte du concessionnaire est accessible depuis le site WordPress.

L'accent est mis ici sur l'aspect intégration du travail — la relation entre l'extension, le compte AutoScout24 du concessionnaire et les personnes qui fournissent l'accès à l'API. Pour un guide étape par étape des champs de la page des réglages, consultez Configuration des identifiants API.

Quand utiliser ce document

Utilisez ce document si vous devez :

Planifier une nouvelle intégration de l'extension avec l'accès API AutoScout24 d'un concessionnaire.
Vérifier qu'un concessionnaire dispose bien du type d'accès API requis par l'extension avant de commencer la configuration WordPress.
Coordonner avec un partenaire d'intégration ou avec le contact informatique du concessionnaire pour obtenir ou renouveler les valeurs d'accès à l'API.
Valider après configuration que le site WordPress peut communiquer avec l'API AutoScout24.

Le public cible est un administrateur ou intégrateur WordPress travaillant en collaboration avec la personne qui gère l'accès à l'API AutoScout24 du concessionnaire. AD Promotion ne fournit pas d'accès à l'API AutoScout24 ; les identifiants proviennent toujours du propre compte du concessionnaire ou du partenaire qui fournit l'accès pour le compte du concessionnaire.

Aperçu

ADP Car Market Hub est conçu autour de l'API officielle AutoScout24. L'extension s'authentifie via un flux de client credentials OAuth2 auprès d'un hôte API configuré par l'administrateur, demande un jeton d'accès, puis appelle les points de terminaison des annonces pour importer les véhicules dans le type de publication personnalisé as24ci_car.

En pratique, l'intégration implique trois parties indépendantes :

Le concessionnaire. Propriétaire du compte AutoScout24 et des données d'annonces du concessionnaire.
Le fournisseur de l'API. AutoScout24, ou un partenaire d'intégration qui expose les données AutoScout24 via une passerelle équivalente. Cette partie fournit l'URL de base de l'API, le ou les Seller ID, ainsi que le Client ID et le Client Secret OAuth.
Le site WordPress. Contient la configuration de l'extension, stocke les identifiants dans la table des options de WordPress et effectue les importations périodiques.

L'extension utilise exactement l'hôte API et les identifiants que vous configurez — il n'y a pas d'hôte AutoScout24 codé en dur dans l'extension. Cela permet de faire pointer la même installation de l'extension vers différents environnements (par exemple, un bac à sable pour les tests et l'API de production pour le site en direct) en modifiant simplement la configuration.

Prérequis

Avant de configurer la connexion API de l'extension, confirmez les points suivants :

Le concessionnaire dispose d'un accès API à AutoScout24 (ou à une passerelle d'intégration équivalente) pour le ou les Seller ID devant être importés. L'identifiant de connexion standard au site web de concessionnaire AutoScout24 n'est pas un identifiant API et ne peut pas être utilisé par l'extension.
Vous avez reçu, via un canal sécurisé, les valeurs dont l'extension a besoin :
URL de base de l'API – l'URL HTTPS complète de l'environnement AutoScout24 ou de la passerelle partenaire.
Seller ID (un ou plusieurs) – l'identifiant ou les identifiants de compte stables fournis par le fournisseur de l'API. Le Seller ID n'est pas le nom d'affichage du concessionnaire sur le site web AutoScout24.
Client ID – l'identifiant client OAuth.
Client Secret – le secret client OAuth qui est associé au Client ID.
Le site WordPress respecte les exigences d' hébergement, de PHP et base de données ainsi que d' API, réseau et SSL. Les requêtes HTTPS sortantes vers l'hôte de l'API doivent être autorisées.
Un compte administrateur est disponible sur le site WordPress.

Si l'une de ces valeurs est inconnue, ne l'inventez pas. Contactez la partie qui a fourni l'accès API du concessionnaire et demandez-les via un canal sécurisé.

Instructions étape par étape

La présentation détaillée de l'interface des réglages se trouve dans Configuration des identifiants API. Le flux d'intégration général est le suivant :

Confirmer l'accès API avec le fournisseur. Vérifiez que l'accès API du concessionnaire est actif, que la paire Client ID / Client Secret est valide et que les identifiants sont autorisés pour chaque Seller ID devant être importé. Les concessions multi-sites ont généralement besoin d'une autorisation explicite par Seller ID.
Recevoir les valeurs de manière sécurisée. Utilisez un gestionnaire de mots de passe, un message chiffré ou une autre méthode sécurisée de transfert de fichiers. N'acceptez pas d'identifiants par simple e-mail ou messagerie instantanée.
Configurer l'extension. Dans WordPress, ouvrez Car Market Hub → Réglages et saisissez l'URL de base de l'API, le Seller ID, le Client ID et le Client Secret dans la carte Connexion API & Réglages généraux.
Exécuter le test de connexion. Ouvrez Car Market Hub → Outils et lancez le test de connexion API comme décrit dans Test de connexion. Ne commencez pas à importer des véhicules tant que le test n'a pas réussi.
Lancer d'abord une petite importation. Utilisez l'assistant par lots (Batch-Wizard) ou une seule exécution planifiée avec une limite basse de véhicules avant d'activer l'automatisation complète. Cela permet de valider le comportement de bout en bout sans importer tout le catalogue dès la première tentative.
Activer les importations planifiées. Une fois que l'importation manuelle fonctionne, activez WP-Cron ou configurez un déclencheur cron système. Voir Configuration du Cron système.

Si un problème survient en cours de route, consultez Erreurs de connexion API avant de modifier la configuration.

Référence de configuration

L'extension n'affiche que les champs nécessaires pour communiquer avec l'environnement AutoScout24 configuré. Les libellés ci-dessous correspondent à ceux de Car Market Hub → Réglages.

Champ	Objectif	Source
URL de base de l'API	URL HTTPS complète de l'environnement AutoScout24 ou de la passerelle partenaire. L'extension utilise cette URL exactement telle qu'elle est configurée.	Fournie par AutoScout24 ou par le partenaire d'intégration.
Seller ID	Un ou plusieurs identifiants de compte de concessionnaire. Les Seller ID multiples sont saisis séparés par des virgules.	Fourni avec l'accès API. Ce n'est pas le nom d'affichage du concessionnaire sur le site web AutoScout24.
Client ID	Identifiant client OAuth. À traiter comme confidentiel même s'il n'est pas techniquement secret.	Émis par le fournisseur de l'API.
Client Secret	Secret client OAuth. Stocké dans la table des options de WordPress ; à traiter comme un identifiant sensible.	Émis par le fournisseur de l'API. S'il est perdu, il doit généralement être généré à nouveau — il ne peut pas être récupéré.
Devise par défaut	Utilisée lorsqu'une annonce importée ne fournit pas de valeur de devise. Ce n'est pas un identifiant.	Choisie par l'administrateur en fonction du marché du concessionnaire.

L'extension déduit automatiquement le point de terminaison du jeton (token endpoint) et l'audience du jeton (token audience) OAuth à partir de l'URL de base de l'API configurée ; il n'y a pas de champ d'interface distinct pour ceux-ci. Si le fournisseur de l'API exige des valeurs non standard, contactez AD Promotion ou le partenaire d'intégration avant de modifier quoi que ce soit — la déduction standard est ce que la plupart des environnements attendent.

Notes opérationnelles

Stockage. Les identifiants sont stockés sous forme d'options WordPress. Toute personne disposant d'un accès administrateur WordPress, d'un accès au système de fichiers de la base de données ou d'un accès à une sauvegarde de la base de données peut les lire. Appliquez les mêmes protections que pour tout autre secret géré par votre organisation.
Mise en cache des jetons. L'extension demande un jeton d'accès OAuth avant son premier appel API et le met en cache. Les importations suivantes réutilisent le jeton mis en cache jusqu'à ce qu'il expire. Après avoir renouvelé des identifiants, il est recommandé de vider le cache des jetons depuis Car Market Hub → Outils afin que la requête suivante utilise immédiatement les nouveaux identifiants.
Installations multi-environnements. L'extension n'a pas de commutateur production / bac à sable intégré. Changer d'environnement signifie modifier l'URL de base de l'API, le Seller ID, le Client ID et le Client Secret pour les remplacer par les valeurs de l'environnement cible, puis exécuter à nouveau le test de connexion. Utilisez des identifiants distincts par environnement WordPress afin que l'activité de préproduction ne puisse pas interférer accidentellement avec les données de production.
Concessions multi-sites. Lorsque plusieurs Seller ID sont configurés, ils sont tous interrogés avec le même Client ID / Client Secret. Les identifiants doivent être autorisés pour chaque Seller ID de la liste — sinon, les vendeurs individuels échoueront avec une erreur d'autorisation lors de l'importation.
Journalisation. Les appels API et les demandes de jetons sont enregistrés dans le répertoire des journaux de l'extension dans wp-content/uploads/as24ci-logs/. Les journaux contiennent suffisamment de détails pour diagnostiquer les problèmes, mais le Client Secret n'est pas écrit en texte clair. Traitez le répertoire des journaux comme confidentiel.
Coordination avec le fournisseur de l'API. L'extension ne peut faire que ce que le fournisseur de l'API autorise. Si l'accès API du concessionnaire est suspendu, limité ou restreint à un sous-ensemble de Seller ID, l'extension signalera ces échecs mais ne pourra pas les contourner. Signalez toujours ces problèmes à la partie qui a fourni l'accès.

Validation de l'accès au compte

Après avoir configuré l'extension, validez l'accès dans cet ordre :

Test de connexion. Exécutez le test de connexion API sur Car Market Hub → Outils. Un résultat positif confirme que l'URL de base de l'API est accessible, que le flux OAuth réussit et que le premier Seller ID configuré est reconnu par l'API. Voir Test de connexion.
Importation manuelle d'un petit lot. Utilisez l'assistant par lots (Batch-Wizard) pour importer un petit nombre de véhicules. Confirmez que les annonces apparaissent sous Car Market Hub → Véhicules et que les prix, la devise et les attributs de base semblent corrects.
Vérification de l'importation des images. Confirmez que la première image de chaque véhicule de test a été téléchargée et jointe. Si le traitement des images est en file d'attente, vérifiez l'état de la file d'attente des images sur Car Market Hub → Importations & Limites.
Onglet Système & Aide. Examinez les indicateurs de diagnostic sur l'onglet Système & Aide pour confirmer qu'il n'y a pas d'avertissements en suspens concernant la connectivité API, la planification ou le stockage.

Vérifiez ce flux de validation dans la version actuelle de l'extension avant de publier des instructions destinées aux clients, car les libellés de l'interface utilisateur peuvent évoluer d'une version à l'autre.

Dépannage

Symptôme	Cause probable	Ce qu'il faut vérifier
Le test de connexion signale une erreur d'authentification.	Mauvais Client ID / Client Secret, environnement incorrect, ou espace collé dans un champ d'identifiant.	Saisissez à nouveau le Client ID et le Client Secret. Confirmez auprès du fournisseur de l'API que les valeurs sont valides pour l'URL de base de l'API configurée.
Le test de connexion signale "aucun Seller ID configuré".	Le champ Seller ID n'a pas été enregistré ou ne contient que des espaces / une virgule parasite.	Rouvrez les Réglages, saisissez à nouveau le Seller ID et enregistrez à nouveau.
Le test de connexion échoue avec une erreur réseau ou SSL.	Les requêtes HTTPS sortantes vers l'hôte de l'API sont bloquées, le bundle CA du serveur est obsolète ou le DNS ne résout pas l'hôte.	Voir Exigences relatives à l'API, au réseau et au SSL et Erreurs de connexion API.
La connexion fonctionne mais aucun véhicule n'est importé pour un Seller ID spécifique.	Les identifiants ne sont pas autorisés pour ce Seller ID, ou le vendeur n'a aucune annonce publiée.	Contactez le fournisseur de l'API pour confirmer l'autorisation. Vérifiez sur le compte AutoScout24 du concessionnaire que les annonces sont actives.
Après le renouvellement des identifiants, les anciens semblent toujours être utilisés.	Le jeton d'accès mis en cache n'a pas encore expiré.	Videz le cache des jetons depuis Car Market Hub → Outils et relancez le test de connexion.
L'importation fonctionne partiellement mais certains véhicules échouent de manière répétée.	Problèmes de données du côté du fournisseur ou limitation du débit (rate limiting) sur l'API.	Examinez les journaux de l'extension dans `wp-content/uploads/as24ci-logs/` et signalez les échecs répétitifs au fournisseur de l'API avec les extraits de journaux pertinents (en masquant les secrets).