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 »