API pour obtenir les informations sur une prestation d’optimisation avec 1.fr

API pour obtenir les informations sur une prestation d’optimisation avec 1.fr

Si vous êtes un membre de Bulldoz, vous pouvez obtenir des informations sur une prestation d’optimisation 1.fr 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/apiInfoPrestationOptimisation1fr.php

Avec en paramètre :

  • CleApi : Votre clé API.
  • IdentifiantPrestation : L’identifiant de la prestation.

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, les informations sur la prestation d’optimisation 1.fr ont bien été retournées. » (en unicode).
  • IdentifiantClient : le numéro unique d’identification du client qui a commandé cette prestation.
  • Libelle : le nom de la prestation.
  • DateCommande : La date a laquelle la commande a été passée.
  • Statut : le statut de la prestation (voir les valeurs possibles plus bas).
  • PrixHt : le prix Hors Taxes de la prestation.
  • Texte : le coe HTML du texte à optimiser.
  • MotCle : le mot-clé pour lequel le texte doit être optimisé

Exemple de retour en cas de réussite :

{« Retour »: »Ok », »Message »: »Ok, votre demande a bien \u00e9t\u00e9 retourn\u00e9e. », “Identifiant”:”123″, “NumeroClient”:”456″, …},… ]}

Statut d’une prestation

Le statut d’une prestation évolue en fonction de son évolution :

  • EnAttenteReponsePrestataire : La prestation doit être accepté  ou refusé par le rédacteur.
  • PrestataireNAPasRepondu : Le temps n’a pas donné de réponse et le délai pour livrer est dépassé.
  • RefuseParPrestataire : La prestation a été refusé par le prestataire.
  • EnCoursDeRealisation : Le rédacteur a accepté la prestation et est en train de rédiger le texte.
  • DateLimiteLivraisonDepasse : Le rédacteur n’a pas livré bien que la date de livraison soit dépassée.
  • ValideAutomatiquement : La prestation a été validé automatiquement par Bulldoz.
  • EnAttenteValidationClient : Le client doit valider le texte livré.
  • Valide : La prestation a été validé par le client
  • Annule : La prestation a été annulée par le client.

Exemple de code PHP utilisant l’API :

$tParametreEntrant = array(

‘CleApi’=>’0123456789Abc’,
‘IdentifiantPrestation’=>’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/ apiInfoPrestationOptimisation1fr.php », false, $context);

$RetourApi = json_decode($RetourApi, 1);

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