API pour commander la rédaction d’un texte

API pour commander la rédaction d’un texte

Si vous êtes membre de Bulldoz, vous pouvez commander la rédaction d’un texte à l’un de vos prestataire via notre API.

Utilisation de l’API

Pour passer une commande de rédaction, vous devez envoyer une requête POST à l’adresse :

https://www.bulldoz.net/api/apiCommanderRedactionTexte.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, il permettra à la personne qui a commandé la rédaction d’avoir des informations sur l’état de la commande. Chaque commande doit avoir un identifiant différent.
  • IdentifiantPrestataire : L’identifiant de l’entreprise qui est chargée de réaliser la prestation.
  • Titre : Le titre du texte à rédiger.
  • NbMots : Le nombre de mots à rédiger.
  • Brief (facultatif) : Le brief pour le rédacteur.
  • Correction (facultatif) : Mettez 1 si si vous souhaitez une amélioration par un rédacteur français.
  • Optimisation (facultatif) : Mettez 1 si vous souhaitez que le texte soit optimisé avec 1.fr .
  • MotCle (facultatif) : Le mot-clé sur lequel le texte doit être optimisé.
  • Test (facultatif) : Mettez 1 si vous souhaitez que l’API retourne un résultat normal, mais que la commande finale ne soit pas passée.

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 »: »Vous n’avez pas renseign\u00e9 le param\u00e8tre CleApi »}

Si la commande a réussi :

  • Retour : « Ok ».
  • Message : « Ok, votre demande a été bien prise en compte. » (en unicode).

Exemple de retour en cas de réussite :

{« Retour »: »Ok », »Message »: »Ok, votre demande a \u00e9t\u00e9 bien prise en compte. »}

Exemple de code PHP utilisant l’API :

$tParametreEntrant = array(

‘CleApi’=>’0123456789Abc’,
‘IdentifiantCommande’=>’33696’,
‘IdentifiantPrestataire’=>’1’,
‘Titre’=>’Les avantages de la loi Pinel’,
‘NbMots’=>’500’,
‘Brief’=>’Merci de rédiger un texte expliquant ce qu’est la loi Pinel et comment elle permet de défiscaliser’,
‘Correction’=>’1’,
‘Optimisation’=>’1’,
‘MotCle’=>’defiscalisation loi pinel’,
‘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(« http://www.bulldoz.net/api/apiCommanderRedactionTexte.php », false, $context);

$RetourApi = json_decode($RetourApi, 1);

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

Faire un test

Pour faire un test de l’API, utilisez le paramètre ‘Test’ avec la valeur 1, ce qui permettra d’obtenir un comportement normal de l’API sans que la commande soit envoyée.