API pour suivre une commande

API pour suivre une commande

Dernière mise à jour le 16/11/2026, par François Tréca

Si vous êtes membre de Bulldoz, vous pouvez suivre l’avancement d’une commande d’article sponsorisé ou de pack d’articles sponsorisés via l’API. Elle retourne les informations affichées sur la page de la commande dans votre compte Bulldoz.

Utilisation de l’API

Pour consulter une commande, envoyez une requête POST (ou GET) à l’adresse :

https://www.bulldoz.com/api/apiStatutCommande.php

Avec en paramètre :

  • CleApi : votre clé API.
  • MotDePasse : votre mot de passe.
  • CommandeId : l’identifiant Bulldoz de la commande, retourné dans CommandeId lors de la commande par l’API.

Seules vos propres commandes sont accessibles. Les autres types de commandes ne sont pas gérés par cette API.

Privilégiez le POST : avec un GET, votre mot de passe apparaît dans l’adresse de la requête.

Retour de l’API

L’API retourne un tableau JSON.

Si la requête a échoué

  • Retour : « Erreur »
  • IdentifiantErreur : l’identifiant de l’erreur.
  • Message : un message expliquant la cause de l’erreur (en unicode).
IdentifiantErreurCause
1-0, 1-1, 1-2Un paramètre obligatoire est absent (CleApi, MotDePasse, CommandeId).
2-2La combinaison clé API / mot de passe est erronée.
3-1CommandeId n’est pas un nombre entier positif.
3-2Aucune commande de votre compte ne porte cet identifiant.
3-3Cette commande n’est ni un article sponsorisé ni un pack d’articles sponsorisés.

Si la requête a réussi, Retour vaut « Ok » et la réponse contient les champs suivants.

Champs communs aux deux types de commande

ChampDescription
CommandeIdL’identifiant de la commande.
TypeCommandeArticleSponsorise ou PackArticlesSponsorises.
LibelleLe libellé de la commande.
StatutLe code du statut (voir ci-dessous).
LibelleStatutLe statut en français.
DateStatutLa date du statut actuel, au format AAAA-MM-JJ HH:MM:SS.
EstEnCourstrue si la commande est en attente ou en cours de réalisation.
EstTermineetrue si la commande est terminée.
EstAnnuleetrue si la commande est annulée ou refusée.
DateCommandeLa date de la commande.
DateAcceptationLa date d’acceptation par le prestataire, ou null.
PrixHtLe prix en euros hors taxes.

Les dates non renseignées valent null.

Valeurs de Statut

StatutSignification
EnAttenteReponsePrestataireLe prestataire n’a pas encore accepté la commande.
EnAttenteLivraisonArticle sponsorisé : commande acceptée, article en cours de réalisation.
EnAttenteValidationClientArticle sponsorisé : article publié, en attente de votre validation.
EnCoursDePublicationPack : campagne en cours de publication.
TermineLa commande est terminée.
AnnuleParClient, AnnuleParPrestataire, RefuseParPrestataireLa commande est annulée ou refusée.

Une fois la commande terminée, le statut peut aussi indiquer l’étape de facturation (EnAttenteFacturation, EnAttenteDeclarationPaiement, EnAttenteValidationReceptionPaiement, Paye, NonFactureViaBulldoz). Pour savoir si une commande est terminée, utilisez EstTerminee.

Champs d’un article sponsorisé

ChampDescription
NomDeDomaineLe site sur lequel l’article est publié.
Titre, Url, AncreLe titre, l’URL du lien et l’ancre demandés.
EstPublicationDesQuePossibletrue si vous avez demandé une publication dès que possible.
DatePublicationSouhaiteeLa date de publication souhaitée.
EstPublietrue si l’article est publié.
DatePublicationLa date de publication, ou null.
UrlArticleL’URL de l’article publié, vide tant qu’il n’est pas publié.
EstValideParClient, DateValidationIndique si vous avez validé l’article, et quand.
EstIndexationGoogleDetectee, DateIndexationGoogleIndique si l’indexation de l’article par Google a été détectée, et quand.

Champs d’un pack d’articles sponsorisés

ChampDescription
DateDemarrage, DateFinLes dates de la campagne.
ListeUrlCibleLe tableau des URL cibles.
NbArticleLe nombre d’articles commandés.
NbArticlePublieLe nombre d’articles déjà publiés.
EstStoppeParClient, DateStopIndique si la campagne a été stoppée par vous, et quand.
EstPublicationTerminee, DatePublicationTermineeIndique si tous les articles sont publiés, et quand.
ArticlesLa liste détaillée des articles (voir ci-dessous). Elle reste vide tant que les sites ne sont pas sélectionnés.

Chaque élément de Articles contient :

ChampDescription
NumeroLe rang de l’article, par date de publication prévue.
StatutPublie ou EnAttente.
DatePublicationPrevueLa date à partir de laquelle l’article sera publié.
DatePublicationLa date de publication, ou null.
UrlArticleL’URL de l’article publié, vide tant qu’il n’est pas publié.
UrlCible, AncreLa page ciblée par le lien et l’ancre utilisée.
EstIndexationGoogleDetectee, DateIndexationGoogleIndexation par Google, si elle est détectée.

Exemple de retour pour un pack (abrégé : la réponse réelle contient tous les champs listés ci-dessus) :

{
  "Retour": "Ok",
  "CommandeId": 123456,
  "TypeCommande": "PackArticlesSponsorises",
  "Statut": "EnCoursDePublication",
  "LibelleStatut": "Campagne en cours de publication",
  "EstEnCours": true,
  "NbArticle": 2,
  "NbArticlePublie": 1,
  "Articles": [
    { "Numero": 1, "Statut": "Publie", "DatePublication": "2026-11-05", "UrlArticle": "https://exemple.fr/article" },
    { "Numero": 2, "Statut": "EnAttente", "DatePublicationPrevue": "2026-11-20", "UrlArticle": "" }
  ]
}

Exemple de code PHP utilisant l’API

<?php
$tParametre = array(
    'CleApi' => 'VOTRE_CLE_API_123',
    'MotDePasse' => 'VOTRE_MOT_DE_PASSE',
    'CommandeId' => 123456
);

$postdata = http_build_query($tParametre);
$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.com/api/apiStatutCommande.php', false, $context);
$RetourApi = json_decode($RetourApi, 1);
print_r($RetourApi);
?>