API pour récupérer un texte

API pour récupérer un texte

Si vous êtes membre de Bulldoz, vous pouvez commander la rédaction d’un texte via une API. Une fois que le texte est rédigé, vous pouvez le récupérer via une API.

Utilisation de l’API

Pour récupérer un texte, vous devez envoyer une requête POST à l’adresse :

https://www.bulldoz.net/api/apiResultatCommande.php

Avec en paramètre :

  • CleApi : La clé API de la personne de l’entreprise qui demande la prestation.
  • IdentifiantCommande : L’identifiant de la commande que vous avez donné lors de la commande.

Retour de l’API

L’API retourne un tableau JSON contenant le résultat de l’API.

Si la commande a échoué :

  • Retour : « Erreur »
  • NumeroErreur : L’identifiant de l’erreur.
  • Message : Un message expliquant la cause de l’erreur (en unicode).

Exemple de retour avec erreur :

{« Retour »: »Erreur », »NumeroErreur »: »1-0″, »Message »: »Il n’y a pas de commande correspondant \u00e0 cet identifiant. »}

Si la commande a réussi :

  • Retour : « Ok ».
  • Message : « Ok, votre demande a été bien prise en compte. » (en unicode).
  • Texte : Le texte qui a été rédigé

Exemple de retour en cas de réussite :

{« Retour »: »Ok », »Message »: »La commande est termin\u00e9\u00e9. », »Texte »: »Voici votre texte »}

Exemple de code PHP utilisant l’API :

$tParametres = array(

‘CleApi’=>’0123456789Abc’,
‘IdentifiantCommande’=>’33696’

);

$postdata = http_build_query($tParametres);

$opts = array(‘http’ =>
array(
‘method’ => ‘POST’,
‘header’ => ‘Content-type: application/x-www-form-urlencoded’,
‘content’ => $postdata
)
);

$context = stream_context_create($opts);

$RetourApi = file_get_contents(« https://www.bulldoz.net/api/apiResultatCommande.php », false, $context);

$RetourApi = json_decode($RetourApi, 1);

echo $RetourApi[‘Retour’]; // Affiche « Ok » ou « Erreur »