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
CommandeIdlors 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).
| IdentifiantErreur | Cause |
|---|---|
| 1-0, 1-1, 1-2 | Un paramètre obligatoire est absent (CleApi, MotDePasse, CommandeId). |
| 2-2 | La combinaison clé API / mot de passe est erronée. |
| 3-1 | CommandeId n’est pas un nombre entier positif. |
| 3-2 | Aucune commande de votre compte ne porte cet identifiant. |
| 3-3 | Cette 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
| Champ | Description |
|---|---|
| CommandeId | L’identifiant de la commande. |
| TypeCommande | ArticleSponsorise ou PackArticlesSponsorises. |
| Libelle | Le libellé de la commande. |
| Statut | Le code du statut (voir ci-dessous). |
| LibelleStatut | Le statut en français. |
| DateStatut | La date du statut actuel, au format AAAA-MM-JJ HH:MM:SS. |
| EstEnCours | true si la commande est en attente ou en cours de réalisation. |
| EstTerminee | true si la commande est terminée. |
| EstAnnulee | true si la commande est annulée ou refusée. |
| DateCommande | La date de la commande. |
| DateAcceptation | La date d’acceptation par le prestataire, ou null. |
| PrixHt | Le prix en euros hors taxes. |
Les dates non renseignées valent null.
Valeurs de Statut
| Statut | Signification |
|---|---|
| EnAttenteReponsePrestataire | Le prestataire n’a pas encore accepté la commande. |
| EnAttenteLivraison | Article sponsorisé : commande acceptée, article en cours de réalisation. |
| EnAttenteValidationClient | Article sponsorisé : article publié, en attente de votre validation. |
| EnCoursDePublication | Pack : campagne en cours de publication. |
| Termine | La commande est terminée. |
| AnnuleParClient, AnnuleParPrestataire, RefuseParPrestataire | La 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é
| Champ | Description |
|---|---|
| NomDeDomaine | Le site sur lequel l’article est publié. |
| Titre, Url, Ancre | Le titre, l’URL du lien et l’ancre demandés. |
| EstPublicationDesQuePossible | true si vous avez demandé une publication dès que possible. |
| DatePublicationSouhaitee | La date de publication souhaitée. |
| EstPublie | true si l’article est publié. |
| DatePublication | La date de publication, ou null. |
| UrlArticle | L’URL de l’article publié, vide tant qu’il n’est pas publié. |
| EstValideParClient, DateValidation | Indique si vous avez validé l’article, et quand. |
| EstIndexationGoogleDetectee, DateIndexationGoogle | Indique si l’indexation de l’article par Google a été détectée, et quand. |
Champs d’un pack d’articles sponsorisés
| Champ | Description |
|---|---|
| DateDemarrage, DateFin | Les dates de la campagne. |
| ListeUrlCible | Le tableau des URL cibles. |
| NbArticle | Le nombre d’articles commandés. |
| NbArticlePublie | Le nombre d’articles déjà publiés. |
| EstStoppeParClient, DateStop | Indique si la campagne a été stoppée par vous, et quand. |
| EstPublicationTerminee, DatePublicationTerminee | Indique si tous les articles sont publiés, et quand. |
| Articles | La 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 :
| Champ | Description |
|---|---|
| Numero | Le rang de l’article, par date de publication prévue. |
| Statut | Publie ou EnAttente. |
| DatePublicationPrevue | La date à partir de laquelle l’article sera publié. |
| DatePublication | La date de publication, ou null. |
| UrlArticle | L’URL de l’article publié, vide tant qu’il n’est pas publié. |
| UrlCible, Ancre | La page ciblée par le lien et l’ancre utilisée. |
| EstIndexationGoogleDetectee, DateIndexationGoogle | Indexation 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);
?>