Erreurs de connexion API

Ce document couvre les problèmes de connexion API courants qui peuvent empêcher l'extension ADP Car Market Hub de récupérer les annonces de véhicules à partir de l'API AutoScout24. Il répertorie les causes probables, les contrôles de diagnostic et les étapes correctives.

Quand utiliser ce document

Lisez ce document lorsque :

• La page État du système signale une erreur de connexion ou affiche « Non connecté ».
• Les exécutions d'importation produisent zéro résultat et le journal contient des erreurs d'authentification ou HTTP.
• Les tentatives d'importation manuelle renvoient des messages d'erreur liés aux identifiants, aux jetons ou à des points de terminaison inaccessibles.

Aperçu

L'extension se connecte à l'API publique AutoScout24 en utilisant un flux d'identifiants client OAuth 2.0. Avant chaque requête API, elle demande un jeton d'accès au point de terminaison de jeton configuré et met en cache le jeton dans une valeur transitoire WordPress pour la durée de sa validité. Toutes les requêtes authentifiées incluent un jeton Bearer dans l'en-tête Authorization.

Les échecs de connexion peuvent se produire à trois niveaux :

1. Configuration manquante ou invalide – les réglages requis sont vides ou incorrects.
2. Échec de la demande de jeton – le point de terminaison de jeton a renvoyé une erreur ou était inaccessible.
3. Échec de la requête API – le jeton a été obtenu mais un appel API ultérieur a échoué avec une erreur HTTP ou un corps de réponse invalide.

Prérequis

Les réglages suivants doivent être configurés dans l'administration de l'extension avant qu'une connexion puisse réussir :

Ces valeurs sont fournies par le service API. Vérifiez-les par rapport à votre compte API AutoScout24 ou aux identifiants fournis par le fournisseur d'intégration. Ne saisissez pas d'identifiants de test dans un environnement de production.

Étapes de diagnostic

Étape 1 : Vérifier la page État du système

1. Dans l'administration WordPress, allez sur l'onglet Système et aide de l'extension.
2. Regardez l'indicateur d'état de la connexion. - S'il affiche un message d'erreur spécifique, notez le code d'erreur et le texte du message. - S'il affiche « Non connecté – aucun Seller ID configuré dans les Réglages », passez à l'étape 2.

Étape 2 : Vérifier les réglages de l'extension

1. Allez sur l'onglet Réglages de l'extension.
2. Confirmez que API Base URL, Client ID, Client Secret et Seller ID(s) sont tous renseignés.
3. Confirmez que l'URL de base n'a pas de barre oblique finale et correspond au format https://….
4. Si vous avez configuré une Token URL ou une Token Audience personnalisée, vérifiez qu'elles sont correctes.
5. Enregistrez les réglages et testez à nouveau la connexion depuis la page État du système.

Étape 3 : Lire le fichier journal

Ouvrez le fichier journal de l'extension à l'adresse :

wp-content/uploads/as24ci-logs/adp-car-market-hub.log

Recherchez les entrées récentes contenant les codes d'erreur ou mots-clés suivants :

Note : le journal masque automatiquement les valeurs des identifiants. Vous verrez client_secret=*** et Bearer *** à la place des valeurs réelles.

Étape 4 : Tester la connectivité réseau

Si le journal confirme que l'extension a tenté une requête mais a reçu une erreur de connexion :

1. Confirmez que votre serveur peut atteindre le point de terminaison de l'API externe. Utilisez un outil tel que curl ou wp shell (WP-CLI) pour effectuer une requête HTTP de test depuis le serveur.
2. Vérifiez que votre environnement d'hébergement ne bloque pas les connexions HTTPS sortantes sur le port 443.
3. Vérifiez qu'un pare-feu, un proxy ou une extension de sécurité ne bloque pas les appels wp_remote_post ou wp_remote_get.
4. Confirmez que le domaine du point de terminaison de l'API est correctement résolu depuis votre serveur (résolution DNS).

Étape 5 : Vérifier les identifiants expirés ou renouvelés

Si la connexion fonctionnait auparavant et s'est arrêtée :

1. Confirmez auprès du fournisseur de l'API ou dans les réglages de votre compte que le Client ID et le Client Secret sont toujours valides et n'ont pas été renouvelés ou révoqués.
2. Supprimez la valeur transitoire du jeton d'accès mis en cache. La clé transitoire est as24ci_access_token. Vous pouvez la supprimer depuis l'administration WordPress via Outils → Supprimer les transients (nécessite une extension de gestion des transients) ou en exécutant delete_transient('as24ci_access_token') via WP-CLI.
3. Testez à nouveau la connexion.

Référence de configuration

Notes opérationnelles

• Le jeton d'accès est mis en cache dans une valeur transitoire WordPress (as24ci_access_token) pour la durée signalée par le champ expires_in dans la réponse du jeton, moins 60 secondes comme marge de sécurité.
• Toutes les requêtes API utilisent un délai d'expiration HTTP de 30 secondes. Sur les hébergements mutualisés avec des limites de délai d'expiration basses, les requêtes peuvent échouer. Vérifiez ce comportement dans la version actuelle de l'extension avant la publication.
• L'extension utilise wp_remote_post et wp_remote_get, qui respectent les filtres et réglages de l'API HTTP de WordPress. Toute extension ou configuration qui modifie ou désactive l'API HTTP de WordPress peut affecter la connectivité.
• L'API Market Hub (utilisée pour les données de comparaison de prix) utilise une URL de base distincte (https://api.car-market-hub.ad-promotion.ch/v1). L'accès à celle-ci est régi par la licence de votre extension, et non par une clé saisie séparément — il n'y a pas de clé API Hub gérée par le client. Les problèmes de connexion avec les données Market Hub n'affectent pas l'importation principale AutoScout24. Voir Problèmes d'analyses de marché.

Dépannage

Documents connexes

• Aperçu du dépannage
• Erreurs d'importation
• Erreurs de Cron