API pour livrer un texte

API pour livrer un texte

Si vous êtes rédacteur de Bulldoz, vous pouvez livrer un texte via notre API.

Utilisation de l’API

Pour obtenir la liste de vos prestations, vous devez envoyer une requête POST à l’adresse :

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

Avec en paramètre :

  • CleApi : La clé API du rédacteur.
  • IdentifiantPrestation : L’identifiant de la prestation de rédaction.
  • Texte : Le texte à livrer.
  • MessagePourClient (facultatif) : Un message accompagnant le texte et que le client pourra lire.
  • Test (facultatif) : Permet de faire un test, si il vaut 1 l’API réagira normalement mais le texte ne sera livré.

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

{« Retour »: »Erreur », »NumeroErreur »: »1-0″, »Message »: »Vous n’avez pas renseign\u00e9 le param\u00e8tre CleApi »}

Si la commande a réussi :

  • Retour : « Ok ».
  • Message : « Ok, votre texte a été bien livré au client pour validation. » (en unicode).

Exemple de retour en cas de réussite :

{« Retour »: »Ok », »Message »: »Ok, votre demande a bien \u00e9t\u00e9 retourn\u00e9e. »}

Exemple de code PHP utilisant l’API :

$tParametres = array(
‘CleApi’=>’0123456789Abc’,
‘IdentifiantPrestation’=>’33696’,
‘Texte’=>’Ceci est mon texte, sympa non ?’,
‘Test’=>1
);

$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/apiLivrerTexte.php », false, $context);

$RetourApi = json_decode($RetourApi, 1);

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