Documentation · Prise en main

Test de connexion

Ce guide explique comment utiliser le Test de connexion API intégré au plugin ADP Car Market Hub pour vérifier que le site WordPress peut s'authentifier auprès de l'API AutoScout24 et accéder aux annonces du compte concessionnaire configuré.

Le test de connexion est la dernière étape recommandée après la configuration des identifiants et avant le déclenchement de toute importation.

Quand utiliser ce document

Utilisez ce document si vous devez :

Valider une nouvelle installation immédiatement après avoir configuré les identifiants API.
Diagnostiquer une importation qui fonctionnait auparavant et qui a commencé à échouer.
Vérifier qu'un déploiement en production est accessible après une migration de serveur, un changement de certificat ou une mise à jour de pare-feu.
Confirmer que des identifiants renouvelés (nouveau Client Secret) sont acceptés par l'API.
Effectuer les vérifications de routine avant la mise en ligne (voir Liste de contrôle de mise en production).

Le test de connexion est volontairement léger : il émet une seule petite requête d'annonces pour le premier Seller ID configuré et signale le résultat. Il n'importe aucun véhicule et ne modifie aucune donnée.

Pourquoi le test de connexion est important

Le test de connexion est le moyen le plus rapide de confirmer trois choses à la fois :

Le plugin peut joindre l'hôte de l'API configuré (résolution DNS, route réseau, pare-feu, établissement de liaison SSL).
Le plugin peut obtenir un jeton d'accès valide en utilisant le Client ID et le Client Secret configurés auprès du point de terminaison de jeton dérivé de l'URL de base de l'API.
Le Client ID/Secret configuré est autorisé pour le premier Seller ID configuré et l'API renvoie les données d'annonces dans le format attendu.

Une importation complète qui échoue après plusieurs minutes est beaucoup plus difficile à diagnostiquer qu'un test de connexion qui échoue immédiatement. Exécutez toujours le test de connexion en premier.

Avant de commencer

Confirmez les points suivants avant d'ouvrir le test :

Le plugin est installé et activé (Guide d'installation).
Les identifiants de la source AutoScout24 dans Car Market Hub → Universal Import sont renseignés et enregistrés (Configuration des identifiants API) :
API Base URL
Seller ID (au moins un)
Client ID
Client Secret
L'environnement d'hébergement autorise le HTTPS sortant vers l'hôte API configuré. Les prérequis réseau et SSL sont documentés dans API, Network and SSL Requirements.
Vous disposez d'un accès administrateur au site WordPress, afin de pouvoir ouvrir Car Market Hub → Tools.

Instructions étape par étape

Connectez-vous à WordPress en tant qu'administrateur.
Ouvrez Car Market Hub → Tools.
Localisez la carte API Connection Test.
Cliquez sur Test Connection.
Attendez que la page se recharge. Le plugin effectue une requête réelle vers l'API et signale le résultat sous forme de notification d'administration en haut de la page.
Lisez attentivement la notification. Le texte exact reflète le résultat réel de la requête, y compris tout message d'erreur renvoyé par l'API ou par la couche HTTP.
Si le test réussit, continuez avec l'étape suivante de votre configuration ou de votre flux de travail opérationnel.
Si le test échoue, suivez la section Dépannage ci-dessous avant de relancer le test.

Vous pouvez relancer le test de connexion aussi souvent que vous le souhaitez ; il ne modifie aucune donnée.

Interprétation du résultat

Résultat réussi

Un résultat réussi signifie que :

Le plugin a obtenu un jeton d'accès OAuth valide à partir du point de terminaison de jeton dérivé de l'URL de base de l'API.
Le plugin a appelé avec succès le point de terminaison des annonces pour le premier Seller ID configuré.
L'API a renvoyé une réponse dans le format attendu.

Après un résultat réussi, vous pouvez procéder en toute sécurité à une simulation (dry run), à une importation manuelle ou activer la planification automatique.

Un test réussi ne garantit pas à lui seul que :

Chaque Seller ID configuré est autorisé — le test valide uniquement le premier. Si plusieurs Seller ID sont configurés, lancez une simulation (dry run) depuis Tools pour confirmer que chaque vendeur renvoie des données.
Le catalogue complet s'importera sans erreur — les grands catalogues peuvent toujours rencontrer des expirations de délai (timeouts), des problèmes d'hébergeur d'images ou des limites de débit lors d'opérations de longue durée. Utilisez le Batch-Wizard et examinez les journaux.

Résultat échoué

Un résultat échoué signifie que le plugin a rencontré l'une des situations suivantes :

Aucun Seller ID n'est configuré pour la source AutoScout24 sur Universal Import.
La requête HTTP vers l'API a échoué (erreur réseau, DNS, SSL, expiration de délai, trafic sortant bloqué).
L'API a répondu par une erreur (échec d'authentification, échec d'autorisation, erreur côté serveur, charge utile inattendue).

La notification d'échec fait remonter le message d'erreur sous-jacent renvoyé par la couche HTTP ou l'API. Ne négligez pas ce texte — c'est l'indice de diagnostic le plus important.

En cas d'échec, n'activez pas les importations automatiques tant que le test de connexion n'a pas réussi à nouveau.

Que vérifier après un résultat échoué

Parcourez les vérifications ci-dessous dans l'ordre. La plupart des échecs de test de connexion sont causés par l'un des trois premiers éléments.

Complétude des identifiants. Ouvrez la source AutoScout24 sur Car Market Hub → Universal Import et confirmez que l'API Base URL, le Seller ID, le Client ID et le Client Secret sont tous renseignés. Un Seller ID manquant produit un message spécifique "no Seller ID configured".
Exactitude des identifiants. Vérifiez à nouveau les identifiants par rapport à la source de laquelle vous les avez reçus. Recherchez les espaces masqués, les guillemets typographiques, les caractères mal saisis et une paire Client ID/Secret qui ne correspond pas. Voir Configuration des identifiants API.
API Base URL. Confirmez que l'URL est celle attendue par le fournisseur de l'API, qu'elle inclut https:// et qu'elle correspond à l'environnement pour lequel les identifiants ont été émis.
Cache des jetons. Si vous avez récemment renouvelé vos identifiants, le plugin utilise peut-être encore un jeton mis en cache. Videz le cache des jetons depuis Car Market Hub → Tools et relancez le test.
HTTPS sortant. Confirmez avec votre hébergeur que le serveur est autorisé à effectuer des requêtes HTTPS sortantes vers l'hôte API configuré. Voir API, Network and SSL Requirements.
Confiance SSL. Une erreur "certificate verify failed" ou similaire signifie que le trousseau de certificats CA du serveur ne fait pas confiance à la chaîne de certificats de l'hôte API. Mettez à jour le trousseau CA du système d'exploitation / PHP via votre hébergeur.
DNS. Une erreur "could not resolve host" signifie que le serveur ne peut pas résoudre le nom d'hôte de l'API. Résolvez ce problème au niveau du système d'exploitation ou du DNS.
Journaux. Ouvrez Car Market Hub → Logs et examinez les entrées les plus récentes. Le plugin enregistre les requêtes de jetons, les requêtes d'annonces et les erreurs. Le journal contient généralement des détails supplémentaires (code d'état HTTP, cible de la requête) qui expliquent l'échec.
Autorisation du vendeur. Si le test réussit pour un ensemble d'identifiants mais échoue spécifiquement pour un Seller ID particulier lors d'une simulation ou d'une importation, il est probable que les identifiants ne soient pas autorisés pour ce vendeur. Contactez le fournisseur de l'API pour confirmer.

Causes courantes d'un échec de test de connexion

Cause	Symptôme typique	Que faire
Seller ID manquant.	La notification indique qu'aucun Seller ID n'est configuré.	Ajoutez le Seller ID sur la source AutoScout24 dans Universal Import et enregistrez.
Mauvaise API Base URL (faute de frappe, protocole manquant, mauvais pays/environnement).	La requête de jeton échoue immédiatement, ou la réponse n'est pas valide.	Copiez-collez à nouveau l'URL depuis la source. Confirmez avec le fournisseur de l'API quelle URL s'applique au compte concessionnaire.
Mauvais Client ID ou Client Secret.	Erreur liée à l'authentification provenant du point de terminaison du jeton.	Saisissez à nouveau les deux valeurs ensemble ; jamais partiellement.
Incohérence d'environnement.	Les identifiants s'authentifient mais la requête d'annonces renvoie une erreur d'autorisation.	Assurez-vous que l'API Base URL, le Client ID/Secret et le Seller ID appartiennent tous au même environnement.
Trafic sortant bloqué par le pare-feu d'hébergement ou le WAF.	Expiration du délai de connexion ou erreur "could not connect".	Demandez à l'hébergeur d'autoriser le HTTPS sortant vers l'hôte API configuré.
Échec de la confiance SSL.	Erreur mentionnant la vérification du certificat, la CA ou la liaison SSL.	Mettez à jour le trousseau CA du système d'exploitation / PHP via l'hébergeur.
Échec de la résolution DNS.	Erreur mentionnant "could not resolve host".	Vérifiez que le nom d'hôte de l'API est résolu sur le serveur (DNS, fichier hosts).
Point de terminaison de jeton personnalisé ou non standard requis par le fournisseur.	La requête de jeton échoue même avec des identifiants apparemment corrects.	Le plugin dérive automatiquement le point de terminaison de jeton à partir de l'API Base URL. Contactez AD Promotion ou votre partenaire d'intégration avant de modifier ce comportement.
Seller ID non autorisé pour les identifiants.	Le jeton réussit, la requête d'annonces échoue avec une erreur d'autorisation.	Confirmez l'autorisation du vendeur auprès du fournisseur de l'API.
Accès au compte ou à l'API désactivé.	Erreur d'authentification ou d'autorisation renvoyée par l'API.	Contactez le fournisseur de l'API pour vérifier que le compte est actif et que le quota d'API n'a pas été épuisé.
Le serveur ne peut pas du tout effectuer de requêtes sortantes (ex. préproduction isolée).	Chaque requête externe échoue.	Autorisez le trafic sortant ou n'exécutez pas le test de connexion sur cet environnement.

Notes opérationnelles

Non destructif. Le test de connexion n'importe jamais de données, n'en supprime jamais et n'envoie jamais d'e-mails. Il peut être exécuté en production en toute sécurité.
Interaction avec le cache des jetons. Un test réussi remplit le cache du jeton d'accès. Un test échoué ne corrompt rien ; il signale simplement l'erreur.
Vendeur testé. Le test utilise toujours le premier Seller ID configuré. Si votre compte utilise plusieurs Seller ID, complétez le test de connexion par une simulation (dry run) depuis Tools, qui prévisualise les données pour chaque Seller ID configuré sans les importer.
Utilisation en cours d'exploitation. Relancer le test de connexion est l'une des premières étapes de toute enquête sur des "importations qui ont cessé de fonctionner", avant de modifier les réglages.
Journaux. Chaque test produit des entrées dans le journal du plugin (wp-content/uploads/as24ci-logs/). Lors de l'ouverture d'un ticket d'assistance, joignez la section correspondante du journal et une capture d'écran de la notification d'administration.

Dépannage

Symptôme	Cause probable	Ce qu'il faut vérifier
"Not connected – no Seller ID configured in Settings."	Le champ Seller ID est vide.	Ouvrez la source AutoScout24 sur Universal Import, saisissez le Seller ID, enregistrez et réessayez.
"Connection issue – could not fetch listings: …" avec un message de délai d'attente dépassé (timeout) ou "could not connect".	Réseau sortant bloqué, mauvais hôte API, problème de DNS ou de pare-feu.	Vérifiez l'accès réseau et le DNS ; confirmez l'URL de base de l'API (API Base URL) auprès du fournisseur. Voir Configuration requise pour l'API, le réseau et le SSL.
Le message d'erreur mentionne SSL / certificate / CA.	Le serveur ne peut pas valider le certificat TLS de l'hôte API.	Mettez à jour le bundle CA via le fournisseur d'hébergement.
Le message d'erreur mentionne authentication / token / unauthorized.	Mauvais Client ID, mauvais Client Secret, ou mauvaise URL de base de l'API (API Base URL) pour les identifiants.	Saisissez à nouveau les deux champs d'identifiants ; vérifiez que l'URL de base de l'API correspond à l'environnement d'émission.
Le message d'erreur mentionne forbidden / access denied / seller.	Les identifiants sont valides mais non autorisés pour le Seller ID configuré.	Contactez le fournisseur de l'API pour vérifier l'autorisation.
Réponse inattendue de l'API.	L'API a renvoyé des données dans un format que le plugin ne reconnaît pas (changement de fournisseur, proxy interférant avec la réponse).	Capturez les entrées de journal correspondantes et contactez le support AD Promotion.
Le test réussit, mais les importations échouent plus tard.	Problèmes spécifiques au catalogue (délais d'attente, hébergeurs d'images, limites de taux) plutôt que de connectivité.	Utilisez le Batch-Wizard, activez la file d'attente des images et examinez les journaux. Voir Erreurs d'importation et Erreurs d'importation d'images.
Les résultats du test sont incohérents (réussit parfois, échoue parfois).	Problème réseau intermittent ou problème d'API en amont.	Réessayez après un court délai ; examinez le journal pour les codes d'état HTTP. Si le problème persiste, remontez-le au fournisseur d'hébergement et au fournisseur d'API.

Pour des diagnostics de connexion plus larges, voir Erreurs de connexion API et Erreurs de Cron.