Docly Child

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

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 » :

Exemple problème API Blesta

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 :

Logs des modules Blesta

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.