Diagnostic synchros — par log http

Lorsqu'une fonctionnalité de KinTPV communique avec un service web (site e-commerce, synchronisation, etc.), un problème peut parfois empêcher le bon déroulement des échanges.

Il peut s'agir, par exemple :

d'un site Prestashop ;
d'un site WooCommerce ;
d'un service web ;
ou de toute autre application compatible.

Le log HTTP permet d'enregistrer l'intégralité des échanges entre KinTPV et le serveur distant afin d'en déterminer l'origine.

Il constitue l'outil de diagnostic principal en cas de problème.

Le log HTTP n'est pas uniquement destiné au support KinTPV.

Dans de nombreux cas, son contenu permet au développeur du site web ou du module de synchronisation d'identifier immédiatement l'origine d'un dysfonctionnement, sans avoir à reproduire plusieurs fois le problème.

Activation du log

Ouvrez les Préférences > Administrateur.

Avant de commencer un nouveau diagnostic, il est conseillé de repartir d'un fichier vide :

Cliquez sur l'icône Loupe pour ouvrir le fichier de log (s'il existe).
Supprimez son contenu.
Enregistrez le fichier puis fermez votre éditeur de texte.

Cochez ensuite les deux options suivantes :

Log : Méthode HTTP
Log : HTTP retour XML

Enregistrez les Préférences.

Effectuez normalement ensuite les opérations de synchronisation/communication web.

Arrêt du log

Une fois les manipulations terminées :

retournez dans Préférences > Administrateur ;
décochez les deux options de log ;
ouvrez le fichier via la loupe ;
validez rapidement les Préférences afin d'éviter que le fichier continue à être alimenté.

Le fichier obtenu contient alors toutes les informations liées aux échanges du test réalisé.

Que peut-on trouver dans le log ?

Le fichier de log enregistre les requêtes envoyées par KinTPV ainsi que les réponses reçues du serveur distant.

Pour chaque requête, le log enregistre généralement :

la date et l'heure ;
l'URL appelée ;
les paramètres transmis ;
le contenu envoyé au serveur (BODY) ;
le code de réponse HTTP (200, 302, 404, 500…) ;
la réponse complète renvoyée par le serveur.

La réponse du serveur peut notamment contenir :

un XML valide attendu par KinTPV ;
un message d'erreur renvoyé par l'application distante ;
une erreur PHP ;
une page HTML d'erreur ;
ou tout autre élément permettant d'identifier l'origine du problème.

Il permet donc de savoir si le problème provient :

de KinTPV ;
du réseau ;
du serveur web ;
de l'application distante ;
ou encore d'une réponse invalide.

Le log HTTP constitue un véritable historique des échanges entre KinTPV et l'application distante.

En cas de dysfonctionnement, il permet généralement de déterminer si le problème provient de KinTPV, du site web, du module de synchronisation ou de l'application distante.

Il est donc aussi utile au support KinTPV qu'au développeur du site ou du module concerné.

Exemples d'erreurs

Dans de nombreux cas, le problème ne provient pas de KinTPV mais du serveur distant.

Ces informations permettent souvent au développeur du site distant de corriger rapidement le problème, alors qu'un simple message comme “Impossible de lire l'XML de retour” ne donne aucune indication sur sa cause.

"Impossible de lire l'XML de retour"

Cette erreur est l'une des plus fréquemment rencontrées lors des synchronisations.

Elle signifie que KinTPV attend une réponse XML valide, mais le serveur a renvoyé un contenu qui n'est pas un XML exploitable.

Les causes les plus fréquentes sont :

une erreur PHP (Fatal error, Warning, Notice…) ;
une erreur HTTP 500 ;
une page HTML renvoyée à la place du XML attendu ;
une authentification refusée ;
une réponse incomplète (timeout, mémoire insuffisante, traitement interrompu…) ;
un encodage incorrect de la réponse.

Le log HTTP permet généralement de visualiser directement le contenu réellement renvoyé par le serveur et donc d'identifier rapidement la cause du problème.

Lors d'une demande d'assistance, joindre le fichier de log HTTP permet très souvent d'identifier rapidement l'origine du problème, sans avoir à reproduire les manipulations plusieurs fois.

Blocage par Cloudflare

Lors d'une synchronisation avec un site Prestashop, le log HTTP peut révéler qu'une requête n'atteint jamais le module de synchronisation.

Exemple :

HTTP Request :
https://monsite.fr/adminxxxxxxxx/index.php?controller=AdminLogin...

REPONSE : 403
...
<title>Attention Required! | Cloudflare</title>

Dans cet exemple, la connexion à l'administration Prestashop est bloquée par le pare-feu Cloudflare avant même que KinTPV puisse récupérer le jeton de synchronisation.

Le problème ne provient donc ni de KinTPV ni du module Prestashop, mais de la configuration de sécurité du site.

Le développeur ou l'administrateur du site devra alors adapter la configuration de sécurité (Cloudflare/WAF) afin d'autoriser cette requête.