API pour commander un pack d’articles sponsorisés
Dernière mise à jour le 16/11/2026, par François Tréca
Si vous êtes membre de Bulldoz, vous pouvez commander un article sponsorisé à un éditeur via l’API.
Utilisation de l’API
Pour passer une commande d’article sponsorisé, envoyez une requête POST à l’adresse :
https://www.bulldoz.com/api/apiCommanderArticleSponso.php
Les paramètres sont à envoyer en formulaire (application/x-www-form-urlencoded), comme dans l’exemple ci-dessous.
Avec en paramètre :
- CleApi : votre clé API.
- MotDePasse : votre mot de passe.
- NomDeDomaine : le nom de domaine du site sur lequel vous souhaitez publier l’article (exemple :
monsite.fr). Il doit correspondre à un site du catalogue Bulldoz. - Titre : le titre de l’article, de 20 à 150 caractères.
- Url : l’URL du lien à placer dans le texte, de 10 à 200 caractères.
- Ancre : l’ancre du lien à placer dans le texte, de 2 à 100 caractères.
- EstPublicationDesQuePossible :
1si l’article doit être publié dès que possible,0si vous souhaitez une date précise. - DatePublicationSouhaite (obligatoire seulement si
EstPublicationDesQuePossiblevaut0) : la date à partir de laquelle publier, au formatJJ/MM/AAAA, au maximum dans un an. - Test (facultatif) : mettez
1si vous souhaitez que l’API retourne un résultat normal, mais que la commande ne soit pas passée.
Retour de l’API
L’API retourne un tableau JSON contenant le résultat.
Si la commande a échoué
- Retour : « Erreur »
- IdentifiantErreur : l’identifiant de l’erreur.
- Message : un message expliquant la cause de l’erreur (en unicode).
Exemple de retour avec erreur :
{ "Retour" : "Erreur", "IdentifiantErreur": "1-0", "Message" : "Vous n'avez pas renseigné le paramètre CleApi" }
Si la commande a réussi
- Retour : « Ok »
- Message : « Ok, votre commande a été bien prise en compte. » (en unicode).
- CommandeId : l’identifiant Bulldoz de votre commande. Conservez-le : il permet de suivre la commande avec l’API de suivi de commande (page « API pour suivre une commande »).
{ "Retour" : "Ok", "Message" : "Ok, votre commande a été bien prise en compte.", "CommandeId" : 123456 }
Exemple de code PHP utilisant l’API
A noter : en local, l’API retournera probablement un message d’erreur. Veuillez tester sur un serveur web.
<?php
$tParametre = array(
'CleApi' => 'VOTRE_CLE_API_123',
'MotDePasse' => 'VOTRE_MOT_DE_PASSE',
'NomDeDomaine' => 'super-site-editeur.fr',
'Titre' => 'Histoire des présidents français',
'Url' => 'https://www.la-france.fr/presidents-francais',
'Ancre' => 'cliquez ici pour avoir plus de détails',
'EstPublicationDesQuePossible' => '1',
'Test' => 1
);
$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/apiCommanderArticleSponso.php', false, $context);
$RetourApi = json_decode($RetourApi, 1);
print_r($RetourApi);
?>
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.
La valeur de CommandeId sera alors 0.