API pour commander un article sponsorisé
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é, vous devez envoyer 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 : 1 si l’article doit être publié dès que possible, 0 si vous souhaitez une date précise.
- DatePublicationSouhaite (obligatoire seulement si EstPublicationDesQuePossible vaut 0) : La date à partir de laquelle publier, au format « JJ/MM/AAAA », au maximum dans un an.
- Test (facultatif) : Mettez 1 si 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 de l’API.
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\u00e9 le param\u00e8tre 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.
{ "Retour" : "Ok", "Message" : "Ok, votre commande a \u00e9t\u00e9 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 ».