Problèmes d’API

Les problèmes d’API sont les principaux cas que vous pouvez rencontrer lorsque vous travaillez avec des noms de domaine. Chaque fois qu’un domaine est affiché dans l’espace client / d’administration ou qu’une action est demandée sur un nom de domaine particulier, un appel API est effectué.

Chaque cas d’erreur est différent et dépend d’une situation particulière.

Par exemple :

Un enregistrement de domaine peut échouer car une donnée fournie par le client ne respecte pas la syntaxe attendue
Un changement de serveur de noms peut échouer car les serveurs de noms fournis par le client sont erronés
Un bug dans le module fait échouer l’API et un débogage plus approfondi est nécessaire pour comprendre ce qui est demandé par Blesta au module et ce que le module a demandé via l’API

Bon à savoir 💡

Afin de comprendre ces problèmes, vous devez examiner les différents appels correspondants dans les logs.

Exemple

Prenons l’exemple suivant :
Un nom de domaine est déjà enregistré et le client souhaite mettre à jour les informations whois. Pour le contact administratif, il a saisi plusieurs caractères non supportés dans le champ « Adresse 2 » :

Une fois soumis, un message d’erreur s’affiche pour l’utilisateur :

D’accord, mais que faire ? Comment comprendre le problème de votre côté pour aider le client ?

Ouvrez les logs des modules depuis Outils > Journaux, onglet Modules et recherchez l’action dans la liste en fonction de la date/heure. Dans notre exemple, nous avons trouvé les lignes suivantes :

La première entrée indique que Blesta a appelé la fonction manageWhois du module avec les paramètres indiqués dans la colonne Données. Il y a beaucoup d’informations mais dans notre cas, l’information importante est :

[AdminFirstName] => John
[AdminLastName] => Doe
[AdminBodyName] => 
[AdminAddress1] => 264 avenue Arthur Notebart
[AdminAddress2] => wrong string syntax &e"'(-e_ca)=}$^u*$
[AdminCity] => LILLE
[AdminStateProvince] => 01
[AdminPostalCode] => 59160
[AdminCountry] => FR
[AdminPhone] => +33 123456789
[AdminEmailAddress] => admin@netim.com

Nous pouvons constater que « Address 2 » a été rempli avec « wrong string syntax &e »‘(-e_ca)=}$^u*$ »

La deuxième entrée indique que le module a tenté de mettre à jour le contact via l’API avec la fonction SOAP contactcreate

Mais le résultat était :

E13 : Address : Some characters are not accepted (accents, symbols, ...)

Bingo : nous avons constaté que le problème s’est produit parce que le client a demandé une mise à jour des informations du contact administratif du nom de domaine avec une adresse contenant des caractères non pris en charge.