API pour commander un pack d’articles sponsorisés

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

Si vous êtes membre de Bulldoz, vous pouvez commander un pack d’articles sponsorisés 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.net/api/apiCommanderPack.php

Avec en paramètre :

• CleApi : Votre clé api.
• MotDePasse : Votre mot de passe.
• IdentifiantCommande : L’identifiant de votre commande, il vous permettra d’avoir des informations sur l’état de la commande. Chacune de vos commandes doit avoir un identifiant différent.
• ListeUrlCible : Liste des urls cible, séparés par des points-vrgules (exemple : « https://monsite.fr;https://autresite.fr/exemple« )
• DateDemarrage : Date de démarrage de la campagne, au format JJ/MM/AAAA
• DateFin : Date de démarrage de la campagne, au format JJ/MM/AAAA
• NbArticle : Le nombre d’article que vous souhaitez
• 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 »
• NumeroErreur : L’identifiant de l’erreur.
• Message : Un message expliquant la cause de l’erreur (en unicode).
• CommandeId : L’identifiant Bulldoz de votre commande.

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, votre demande a été bien prise en compte. » (en unicode).

{ "Retour" : "Ok", "Message" : "Ok, votre demande 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',
'IdentifiantCommande'=>'VOTRE_ID_COMMANDE_123',
'ListeUrlCible'=>'https://www.votre-site.fr/exemple',
'DateDemarrage'=>'01/07/2024',
'DateFin'=>'05/07/2024',
'NbArticle'=>5,
'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('http://www.bulldoz.net/api/apiCommanderPack.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 ».