Téléphone

Table des matières


Introduction

L'API PriceJet permet de faire communiquer votre système de gestion ou ERP avec notre solution.
Les usages peuvent être divers, vous pouvez par exemple récupérer le prix d'un concurrent dans votre système.
Les flux de données passent par des requêtes HTTP GET.
Vous trouverez dans cet espace les différentes méthodes et options vous permettant d'utiliser ce service.


Authentification

Pour vous connecter et utiliser nos fonctions, vous devez obligatoirement vous authentifier en envoyant une signature.
Elle permet de vous identifier et de rendre l'accès sécurisé.
La signature est construite en concaténant plusieurs variables (date + clef secrète), le tout crypté en MD5.
Vous trouverez votre clef secrète et votre login dans votre espace client, sur votre compte, puis "Paramètres".

SIGNATURE = MD5(DATE(YYYYMMDD)+CLEF)

Voici un exemple de construction de signature en PHP :
<?php 
$clef = "CLEFSECRETE"; // à récupérer dans votre espace client
$signature = md5(date('Ymd').$clef);
?>


Récupérer un prix

  • signature obligatoire
  • Pour vous authentifier.

  • login obligatoire
  • Votre login.

  • article obligatoire
  • Le code article du produit étudié.

  • concurrent (facultatif)
  • L'id du concurrent étudié.
    Vous trouverez l'id du concurrent dans la Gestion / Concurrents.
    Si le paramètre n'est pas renseigné, renvoi le prix minimum parmi l'ensemble des concurrents.

  • type (facultatif)
  • Le type de prix que vous attendez :
    MIN : le prix minimum
    MAX : le prix maximum
    AVG : le prix moyen
    COUNT : le nombre de concurrents sur lequel l'analyse porte

    Si le paramètre concurrent n'est pas vide, type est ignoré.

    float Retourne le prix demandé ou le nombre de concurrents.
    # Description
    ?WAIT Il n'y a pas encore d'analyse pour la demande. Il faut attendre que nos robots scannent l'article.
    ?ACCOUNT Le compte (login) n'existe pas.
    ?AUTH Votre authentification n'est pas correcte. Il y a un problème dans la signature.
    <?php 
    								
    $clef = ""; // à récupérer dans votre espace client
    $signature = md5(date('Ymd').$clef);
    
    //Exemple 1 : Prix minimum de l'article 123
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&article=123";
    
    //Exemple 2 : Prix moyen de l'article 123
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&article=123&type=AVG";
    
    //Exemple 3 : Prix de l'article 123 chez le concurrent 5
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&article=123&concurrent=5";
    
    // Envoi de l'action
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $prix = curl_exec($curl);
    curl_close($curl);
    								
    ?>

    Récupérer une liste

  • signature obligatoire
  • Pour vous authentifier (voir section Connexion).

  • login obligatoire
  • Votre login.

  • liste obligatoire
  • Le type de liste que vous attendez :
    TOUS : Renvoi la liste de tous les codes articles du compte.
    CONCURRENT : Renvoi la liste des concurrents du compte.
    GROUPE : Renvoi la liste des groupes du compte.
    PRIXINFMOY : Renvoi la liste des codes articles dont mon prix est inférieur au prix moyen.
    PRIXSUPMOY : Renvoi la liste des codes articles dont mon prix est supérieur au prix moyen.
    PRIXPLUSCHER : Renvoi la liste des codes articles dont mon prix est le plus cher de tous les concurrents.
    PRIXMOINSCHER : Renvoi la liste des codes articles dont mon prix est le moins cher de tous les concurrents.
    PRIXPASMOINSCHER : Renvoi la liste des codes articles dont mon prix n’est pas le moins cher.

    Json Liste au format JSON.

  • CONCURRENT : Renvoi un tableau JSON formaté de la manière suivante
  • id : la référence unique du concurrent
    nom : le nom du concurrent
    photo : l'url de la photo miniature

  • PRIXINFMOY / PRIXSUPMOY / PRIXPLUSCHER / PRIXMOINSCHER / PRIXPASMOINSCHER / TOUS
  • code : code article

    # Description
    ?WAIT Il n'y a pas encore d'analyse pour la demande. Il faut attendre que nos robots scannent l'article.
    ?ACCOUNT Le compte (login) n'existe pas.
    ?AUTH Votre authentification n'est pas correcte. Il y a un problème dans la signature.
    <?php 
    
    $clef = ""; // à récupérer dans votre espace client
    $signature = md5(date('Ymd').$clef);
    
    //Exemple 1 : Récupère la liste des concurrents
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&liste=CONCURRENT";
    
    //Exemple 2 : Récupère la liste des articles dont mon prix est supérieur au prix moyen.
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&liste=PRIXSUPMOY";
    
    // Envoi de l'action
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $prix = curl_exec($curl);
    curl_close($curl);
    
    ?>

    Ajouter un produit

  • signature obligatoire
  • Pour vous authentifier (voir section Connexion).

  • login obligatoire
  • Votre login.

  • action obligatoire
  • L'action que vous souhaitez réaliser : "ajouter".

  • article obligatoire
  • Le code produit à créer.

  • designation obligatoire
  • La désignation du produit sous forme de chaîne de caractères encodée en accord avec la RFC 3986.

  • prix OU url obligatoire
  • Votre prix du produit ou l'URL du produit sur votre site encodée en accord avec la RFC 3986.

  • prix_achat (facultatif)
  • Le prix d'achat (coût) du produit, afin de calculer votre marge. La valeur doit être un nombre ou une chaîne vide.

  • ean (facultatif)
  • La code barre du produit.

  • ref_fabricant (facultatif)
  • La référence fabricant du produit.

  • photo (facultatif)
  • L'URL de la photo du produit encodée en accord avec la RFC 3986.

  • declinaison (facultatif)
  • La déclinaison de votre produit si nécessaire.

  • groupes (facultatif - formule or uniquement)
  • Les id des groupes dont fait partie le produit, séparés par des points-virgules.

    char Retourne "OK" en cas de réussite.
    # Description
    ?ACTION Il y a un problème avec l'action demandée. L'action doit être "supprimer".
    ?ARTICLE Vous n'avez pas fourni de code produit.
    ?MAXPRODUIT Vous avez atteint le nombre maximum de produits compris dans votre formule.
    ?EXISTE Le code produit existe déjà dans votre liste de produit.
    ?PARAM Vous avez saisi un prix ET une url pour votre produit. Il faut saisir le prix OU l'url mais pas les deux.
    ?CODEARTICLE Le code article ne doit contenir que des chiffres, des lettres ou des tirets (_ ou -)
    ?PRIX Vous avez saisi le prix mais ce n'est pas un nombre.
    ?PRIXACHAT Vous avez saisi le prix d'achat mais ce n'est pas un nombre.
    ?DESIGNATION Vous n'avez pas saisi de désignation.
    ?ACCOUNT Le compte (login) n'existe pas.
    ?AUTH Votre authentification n'est pas correcte. Il y a un problème dans la signature.
    <?php 
    
    $clef = ""; // à récupérer dans votre espace client
    $signature = md5(date('Ymd').$clef);
    
    //Exemple 1 : J'ajoute un produit en saisissant l'URL du produit sur mon site, l'URL de sa photo, son code barre, son prix d'achat
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&action=AJOUTER&article=123456&url=".rawurlencode('http://www.monsite.com/cat-mesproduits/page-produit-123456-mon-produit.html')."&designation=".rawurlencode('La désignation de mon produit')."&ean=0123456789123&prix_achat=12.45&photo=".rawurlencode('http://www.monsite.com/cat-mesproduits/page-produit-123456-mon-produit.jpg');
    
    //Exemple 2 : J'ajoute un produit en saisissant mon prix, sa déclinaison et les id groupes
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&action=AJOUTER&article=123456&prix=12.26&declinaison=".rawurlencode("orange")."&designation=".rawurlencode('La désignation de mon produit')."&groupes=1;2";
    
    // Envoi de l'action
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $retour = curl_exec($curl);
    curl_close($curl);
    ?>

    Modifier un produit

  • signature obligatoire
  • Pour vous authentifier (voir section Connexion).

  • login obligatoire
  • Votre login.

  • action obligatoire
  • L'action que vous souhaitez réaliser : "modifier".

  • article obligatoire
  • Le code produit à modifier

  • prix OU url obligatoire
  • Votre prix du produit ou l'URL du produit sur votre site encodée en accord avec la RFC 3986.

  • prix_achat (facultatif)
  • Le prix d'achat (coût) du produit, afin de calculer votre marge. La valeur doit être un nombre ou une chaîne vide.

  • designation (facultatif)
  • La désignation du produit sous forme de chaîne de caractères encodée en accord avec la RFC 3986.

  • ean (facultatif)
  • La code barre du produit.

  • ref_fabricant (facultatif)
  • La référence fabricant du produit.

  • photo (facultatif)
  • L'URL de la photo du produit encodée en accord avec la RFC 3986.

  • declinaison (facultatif)
  • La déclinaison de votre produit si nécessaire.

  • groupes (facultatif - formule or uniquement)
  • Les id des groupes dont fait partie le produit, séparés par des points-virgules, sous forme de chaîne encodée en accord avec la RFC 3986.

    char Retourne "OK" en cas de réussite.
    # Description
    ?ACTION Il y a un problème avec l'action demandée. L'action doit être "modifier".
    ?ARTICLE Vous n'avez pas fourni de code produit.
    ?EXISTE Le code produit n'existe pas dans votre liste de produit.
    ?PARAM Vous avez saisi un prix ET une url pour votre produit. Il faut saisir le prix OU l'url mais pas les deux.
    ?PRIX Vous avez saisi le prix mais ce n'est pas un nombre.
    ?PRIXACHAT Vous avez saisi le prix d'achat mais ce n'est pas un nombre.
    ?ACCOUNT Le compte (login) n'existe pas.
    ?AUTH Votre authentification n'est pas correcte. Il y a un problème dans la signature.
    <?php 
    
    $clef = ""; // à récupérer dans votre espace client
    $signature = md5(date('Ymd').$clef);
    
    //Exemple 1 : Je modifie l'url, la désignation et supprime le prix d'achat d'un produit
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&action=MODIFIER&article=123456&url=".rawurlencode('http://www.monsite.com/cat-mesproduits/page-produit-123456-mon-produit.html')."&prix_achat=&designation=".rawurlencode('La désignation de mon produit');
    
    //Exemple 2 : Je modifie le prix d'un produit, sa déclinaison et ses groupes
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&action=MODIFIER&article=123456&prix=12.26&declinaison=".rawurlencode("orange")."&groupes=3";
    
    
    // Envoi de l'action
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $retour = curl_exec($curl);
    curl_close($curl);
    ?>

    Supprimer un produit

  • signature obligatoire
  • Pour vous authentifier (voir section Connexion).

  • login obligatoire
  • Votre login.

  • action obligatoire
  • L'action que vous souhaitez réaliser : "supprimer".

  • article obligatoire
  • Le code produit à supprimer.

    char Retourne "OK" en cas de réussite.
    # Description
    ?ACTION Il y a un problème avec l'action demandée. L'action doit être "supprimer".
    ?ARTICLE Vous n'avez pas fourni de code produit.
    ?EXISTE Le code produit à supprimer n'existe pas dans votre liste de produit.
    ?ACCOUNT Le compte (login) n'existe pas.
    ?AUTH Votre authentification n'est pas correcte. Il y a un problème dans la signature.
    <?php 
    
    $clef = ""; // à récupérer dans votre espace client
    $signature = md5(date('Ymd').$clef);
    
    //Exemple : Je supprime le produit qui a le code produit 123456
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&action=SUPPRIMER&article=123456";
    
    // Envoi de l'action
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $retour = curl_exec($curl);
    curl_close($curl);
    ?>

    Ajouter un groupe

  • signature obligatoire
  • Pour vous authentifier (voir section Connexion).

  • login obligatoire
  • Votre login.

  • actiongrp obligatoire
  • L'action que vous souhaitez réaliser : "ajouter".

  • groupe obligatoire
  • L'id du groupe à ajouter

  • libelle obligatoire
  • Le libellé du groupe sous forme de chaîne de caractères encodée en accord avec la RFC 3986.

  • parent (facultatif)
  • L'id du groupe parent de ce groupe.

    char Retourne "OK" en cas de réussite.
    # Description
    ?ACTION Il y a un problème avec l'action demandée. L'action doit être "ajouter".
    ?GROUPE Vous n'avez pas fourni d'id de groupe.
    ?GROUPEFORMAT L'id de groupe ne peut contenir que des chiffres et des lettres.
    ?LIBELLE Vous n'avez pas fourni de libellé au groupe.
    ?PARENT L'id de groupe parent n'existe pas dans votre liste de groupes.
    ?PARENTFORMAT L'id de groupe parent ne peut contenir que des chiffres et des lettres.
    ?EXISTE L'id à ajouter existe déjà dans votre liste de groupes.
    ?ACCOUNT Le compte (login) n'existe pas.
    ?AUTH Votre authentification n'est pas correcte. Il y a un problème dans la signature.
    <?php 
    
    $clef = ""; // à récupérer dans votre espace client
    $signature = md5(date('Ymd').$clef);
    
    //Exemple 1 : J'ajoute le groupe qui a pour id 1A et pour libellé "Nouveau groupe"
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&actiongrp=AJOUTER&groupe=1A&libelle=".rawurlencode('Nouveau groupe');
    
    //Exemple 2 : J'ajoute le groupe qui a pour id 2 et pour libellé "Nouveau groupe" et pour parent le groupe d'id 1
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&actiongrp=AJOUTER&groupe=1&libelle=".rawurlencode('Nouveau groupe')."&parent=1";
    
    // Envoi de l'action
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $retour = curl_exec($curl);
    curl_close($curl);
    ?>

    Modifier un groupe

  • signature obligatoire
  • Pour vous authentifier (voir section Connexion).

  • login obligatoire
  • Votre login.

  • actiongrp obligatoire
  • L'action que vous souhaitez réaliser : "modifier".

  • groupe obligatoire
  • L'id du groupe à modifier

  • libelle OU parent obligatoire
  • Le libellé du groupe sous forme de chaîne de caractères encodée en accord avec la RFC 3986 OU l'id du groupe parent de ce groupe.

    char Retourne "OK" en cas de réussite.
    # Description
    ?ACTION Il y a un problème avec l'action demandée. L'action doit être "modifier".
    ?GROUPE Vous n'avez pas fourni d'id de groupe.
    ?LIBELLE Vous n'avez pas fourni de libellé au groupe.
    ?PARENT L'id de groupe parent n'existe pas dans votre liste de groupes.
    ?PARENTPB Un groupe ne peut pas être son propre parent.
    ?ARBOPB Un groupe ne peut pas avoir pour parent l'un de ses sous-groupes.
    ?PARAM Vous avez saisi un libellé ET un parent. Il faut saisir un libellé OU un parent mais pas les deux.
    ?EXISTE L'id à modifier n'existe pas dans votre liste de groupes.
    ?ACCOUNT Le compte (login) n'existe pas.
    ?AUTH Votre authentification n'est pas correcte. Il y a un problème dans la signature.
    <?php 
    
    $clef = ""; // à récupérer dans votre espace client
    $signature = md5(date('Ymd').$clef);
    
    //Exemple 1 : Je modifie le libellé du groupe qui a pour id 3
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&actiongrp=MODIFIER&groupe=3&libelle=".rawurlencode('Nouveau nom du groupe');
    
    //Exemple 2 : Je modifie le groupe qui a pour id 3 afin que son parent devienne le groupe d'id 1
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&actiongrp=MODIFIER&groupe=3&parent=1";
    
    //Exemple 3 : Je modifie le groupe qui a pour id 3 afin qu'il n'ait plus de parent
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&actiongrp=MODIFIER&groupe=3";
    
    
    // Envoi de l'action
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $retour = curl_exec($curl);
    curl_close($curl);
    ?>

    Supprimer un groupe

  • signature obligatoire
  • Pour vous authentifier (voir section Connexion).

  • login obligatoire
  • Votre login.

  • actiongrp obligatoire
  • L'action que vous souhaitez réaliser : "supprimer".

  • groupe obligatoire
  • L'id du groupe à supprimer.

    char Retourne "OK" en cas de réussite.
    # Description
    ?ACTION Il y a un problème avec l'action demandée. L'action doit être "supprimer".
    ?GROUPE Vous n'avez pas fourni d'id de groupe.
    ?EXISTE L'id à supprimer n'existe pas dans votre liste de groupes.
    ?ACCOUNT Le compte (login) n'existe pas.
    ?AUTH Votre authentification n'est pas correcte. Il y a un problème dans la signature.
    <?php 
    
    $clef = ""; // à récupérer dans votre espace client
    $signature = md5(date('Ymd').$clef);
    
    //Exemple : Je supprime le groupe qui a pour id 5
    $url = "https://api.pricejet.fr?signature=".$signature."&login=&actiongrp=SUPPRIMER&groupe=5";
    
    // Envoi de l'action
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    $retour = curl_exec($curl);
    curl_close($curl);
    ?>