Page 1

Web service par fichier de matching

1 PIXPLACE [PixPlace] 3_Import matching par Web services.doc Š FOTOVISTA S.A.S - Reproduction et communication interdites sans autorisation


IMPORTER VOS FICHIERS .CSV VIA LES WEB SERVICES Web service PixPlace Pour accéder aux web services de PixPlace il vous sera nécessaire de faire appel à une adresse bien précise. Le radical de ces adresses est le suivant : https://pixplace-ws.pixmania.com

Vos identifiants Web Services sont différents de vos accès Back-Office: Login web service: pixplace Password web service: eip7ohNuay

Chaque fonctionnalité que vous souhaiterez utiliser pour l’intégration de votre catalogue produit nécessitera de faire appel en plus du nom de domaine à un ensemble de paramètres qui se résume à cette règle : Nom du service & Nom de la fonctionnalité & Clé de contrôle. Tout au long de ce document, vous trouverez le nom du service et le nom des fonctionnalités que vous devrez indiquer pour utiliser tel ou tel web service. La clé de contrôle, encore appelée serial key, vous sera fournie par votre Account Manager lors de la création de votre compte PixPlace.

Le fonctionnement Les web services fonctionnent sur le principe des requêtes http : il faut faire appel à une url puis encoder en UTF-8 cet appel par le biais de vos applications (tel que l’utilisation de CURL ou l’utilisation d’un formulaire html). Au final, vous envoyez tout ceci à notre service et la réponse que nous vous renvoyons a la forme d’un fichier texte.

La construction La construction de l’adresse d’appel est la suivante : https://pixplace-ws.pixmania.com/index.php?d=webServices_Server&c=ServerRest Lorsque vous envoyez des données en POST, vous devez utilisez cette adresse et rajouter un formulaire contenant les données du tableau qui suit.

2 PIXPLACE [PixPlace] 3_Import matching par Web services.doc © FOTOVISTA S.A.S - Reproduction et communication interdites sans autorisation


Lorsque vous souhaitez faire appel au web service en GET (sans envoi de fichier) l’adresse sera de ce type : https://pixplacews.pixmania.com/index.php?d=webServices_Server&c=ServerRest&rm=[nom_module]&rf=[nom_fonctionnalité]&sl=[serial_k ey] Vous trouverez ci-dessous la liste des paramètres : Paramètre rm

Définition Constitue le module désiré

rf

Constitue la fonctionnalité désirée dans le module Constitue la clé cryptée de contrôle

sl

Commentaire Un module contient une liste de fonctionnalités mises à votre disposition. Une fonctionnalité représente le web service à proprement dit. La clé de contrôle permet d’authentifier l’origine de l’appel et sa validité.

Il existe un web service de démonstration afin de vous permettre de tester la connexion à notre service et que nous vous présentons ci-dessous.

3 PIXPLACE [PixPlace] 3_Import matching par Web services.doc © FOTOVISTA S.A.S - Reproduction et communication interdites sans autorisation


Import du groupe de données <Matching> Envoyer votre fichier <MATCHING> par Web services Le web service ci-dessous vous permet d’envoyer à la plateforme PixPlace votre fichier .csv d’import par le biais d’un formulaire en POST. Suite à cet import vous recevrez un premier fichier de retour, puis éventuellement un deuxième et un troisième si votre import s’est correctement déroulé. Adresse POST : https://pixplace-ws.pixmania.com/index.php?d=webServices_Server&c=ServerRest Paramètre rm rf sl FILENAME

Valeur importFileContr importMatching Votre clé Votre fichier

Commentaire Nom du module Nom de la fonctionnalité Clé de vérification Il s’agit de la désignation de votre liste de paramètres qui peut différer selon le langage d’encapsulation utilisé (PHP, CURL, etc.)

https://pixplace-ws. pixmania.com/index.php?d=webServices_Server&c=ServerRest&rm=importFileContr&rf=importMatching&sl=[Mercha nt Serial]&FILENAME=[ votre file] Récupérer votre fichier de rapport d’upload par Web services Adresse GET : https://pixplace-ws.pixmania.com/index.php?d=webServices_Server&c=ServerRest Paramètre rm rf PARENT_FILE_ID FILE_TYPE_CODE

Valeur exportFile getReportFile Entier MPD

Commentaire Nom du module Nom de la fonctionnalité Identifie de manière unique votre fichier d’import Permet de préciser le type de fichier d’import auquel se rattache le fichier de retour que l’on veut récupérer

FILE_CONTENT_TYPE_CODE

IPT

Permet de préciser le type de fichier de retour que l’on veut récupérer

sl

Votre clé

Clé de vérification

https://pixplace-ws. pixmania.com/index.php?d=webServices_Server&c=ServerRest&rm=exportFile&rf=getReportFile&PARENT_FILE_ID=[file_i d]&FILE_TYPE_CODE=MPD&FILE_CONTENT_TYPE_CODE=IPT& sl=[Merchant Serial] Suite à l’import vous recevrez le premier fichier de retour : Si l’import a réussit, vous recevrez ce message : « Your file has been uploaded and is now verifying by our system. You should be able to download your reporting FILE in few minutes to know if it's accepted. - FILE_ID => XXXXX » Si l’import échoue alors vous recevrez un message d’erreur.

4 PIXPLACE [PixPlace] 3_Import matching par Web services.doc © FOTOVISTA S.A.S - Reproduction et communication interdites sans autorisation


Récupérer votre fichier de rapport d’analyse par Web services Adresse GET : https://pixplace-ws.pixmania.com/index.php?d=webServices_Server&c=ServerRest Paramètre rm rf PARENT_FILE_ID FILE_TYPE_CODE

Valeur exportFile getReportFile Entier MPD

FILE_CONTENT_TYPE_CODE

ITG

sl

Votre clé

Commentaire Nom du module Nom de la fonctionnalité Identifie de manière unique votre fichier d’import Permet de préciser le type de fichier d’import auquel se rattache le fichier de retour que l’on veut récupérer Permet de préciser le type de fichier de retour que l’on veut récupérer Clé de vérification

https://pixplace-ws. pixmania.com/index.php?d=webServices_Server&c=ServerRest&rm=exportFile&rf=getReportFile&PARENT_FILE_ID=[file_i d]&FILE_TYPE_CODE=MPD&FILE_CONTENT_TYPE_CODE=ITG& sl=[Merchant Serial]

Suite à l’import vous recevrez le second fichier de retour : Si l’import a réussit, vous recevrez ce message : « SUCCESS Your file has been accepted by our system and is now analyzing. You could download your REPORTING FILE in the next 24h to know if your data have been created in PixPlace (status=CRE) or not (status=FAI) on each line.» Si l’import échoue alors vous recevrez un message d’erreur.

5 PIXPLACE [PixPlace] 3_Import matching par Web services.doc © FOTOVISTA S.A.S - Reproduction et communication interdites sans autorisation


Récupérer votre fichier de réponse par Web services Adresse GET : https://pixplace-ws.pixmania.com/index.php?d=webServices_Server&c=ServerRest Paramètre rm rf PARENT_FILE_ID FILE_TYPE_CODE

Valeur exportFile getReportFile Entier MPD

FILE_CONTENT_TYPE_CODE

RPT

sl

Votre clé

Commentaire Nom du module Nom de la fonctionnalité Identifie de manière unique votre fichier d’import Permet de préciser le type de fichier d’import auquel se rattache le fichier de retour que l’on veut récupérer Permet de préciser le type de fichier de retour que l’on veut récupérer Clé de vérification

https://pixplace-ws. pixmania.com/index.php?d=webServices_Server&c=ServerRest&rm=exportFile&rf=getReportFile&PARENT_FI LE_ID=[file_i d]&FILE_TYPE_CODE=MPD&FILE_CONTENT_TYPE_CODE=RPT& sl=[Merchant Serial]

Si l’import a réussit, vous recevrez un fichier texte : En rouge le fupid En vert Y ou N (Yes/No) indique si le produit est matché Exemple :

Asics

Asics

fr

AVP00029698 AVP00029698 135 31 31

12386

725 0

Asics

CHAUSSURES <br> Tige synthétique de type cuir et suède

CR E

0304989 5

Si l’import échoue alors vous recevrez un message d’erreur le produit sera en FAI. A noter que le fichier de réponse que vous recevrez sera composé de 13 colonnes, les 11 premières étant identiques à votre fichier d’import et les 3 derniers contenants les informations suivantes : Champs Statut

Type Chaîne

Référence PixPlace

Chaîne

Valeurs 2valeurs possibles : - CRE pour indiquer une ligne produit qui a correctement été importée - FAI pour indiquer une ligne produit qui n’a pas pu être créée Contient l’identifiant unique de votre produit dans notre système PixPlace Il s’agit du FUPID de votre produit

Taille 3 (fixe)

8 (fixe)

6 PIXPLACE [PixPlace] 3_Import matching par Web services.doc © FOTOVISTA S.A.S - Reproduction et communication interdites sans autorisation

Y


EXEMPLES D’UTILISATION EN PHP DES WEB SERVICES Web service POST < ?PHP $oCurl = curl_init(); $sSerial = 'merchant_serial'; $sHttpLogin = 'merchant_login'; $sHttpPwd = 'merchant_password'; $sCalledurl = 'https://pixplace-ws.pixmania.com/index.php?d=webServices_Server&c=ServerRest'; $aParameters = array ( 'rm' => 'importFileContr' , 'rf' => 'importMatching' , 'sl' => $sSerial , 'FILENAME' => '@/File_To_Load/pixplaceImportMatching.csv' ); // Do not forget '@' before the file to be called //Option: Url to call curl_setopt( $oCurl, CURLOPT_URL, $sCalledurl ); //Option: Do not display the result but store it in a variable curl_setopt( $oCurl, CURLOPT_RETURNTRANSFER, 1); //Option: Set HTTPS Login And password curl_setopt( $oCurl, CURLOPT_USERPWD, $sHttpLogin.':'.$sHttpPwd ); curl_setopt( $oCurl, CURLOPT_HTTPAUTH, CURLAUTH_ANY); curl_setopt( $oCurl, CURLOPT_UNRESTRICTED_AUTH, true); curl_setopt( $oCurl, CURLOPT_SSL_VERIFYHOST, 0); curl_setopt( $oCurl, CURLOPT_SSL_VERIFYPEER, false); //Option: Active HTTP Post curl_setopt( $oCurl, CURLOPT_POST, 1); curl_setopt( $oCurl, CURLOPT_HTTPHEADER, array("Expect:") ); //Option: Set HTTP Parameters curl_setopt( $oCurl, CURLOPT_POSTFIELDS, $aParameters ); //Launch Curl Request $sCurlResponse = curl_exec( $oCurl ); exit(); ?>

7 PIXPLACE [PixPlace] 3_Import matching par Web services.doc © FOTOVISTA S.A.S - Reproduction et communication interdites sans autorisation


Web service GET <?PHP $oCurl = curl_init(); $sSerial = 'merchant_serial'; $sHttpLogin = 'merchant_login'; $sHttpPwd = 'merchant_password'; $sCalledurl = 'https://pixplacews.pixmania.com/index.php?d=webServices_Server&c=ServerRest&rm=demo &rf=demo&sl='.$sSerial; //Option: Url to call curl_setopt( $oCurl, CURLOPT_URL, $sCalledurl ); //Option: Do not display the result but store it in a variable curl_setopt( $oCurl, CURLOPT_RETURNTRANSFER, 1); //Option: Set HTTPS Login And password curl_setopt( $oCurl, CURLOPT_USERPWD, $sHttpLogin.':'.$sHttpPwd ); curl_setopt( $oCurl, CURLOPT_HTTPAUTH, CURLAUTH_ANY); curl_setopt( $oCurl, CURLOPT_UNRESTRICTED_AUTH, true); curl_setopt( $oCurl, CURLOPT_SSL_VERIFYHOST, 0); curl_setopt( $oCurl, CURLOPT_SSL_VERIFYPEER, false); //Launch Curl Request $sCurlResponse = curl_exec( $oCurl ); ?>

Web service avec CURL sous Windows c:\curl\curl -k -v -u pixplace:eip7ohNuay --header "Expect:" -O -F rm=exportFile -F rf=exportLastReportFile -F File_type_code="MPD" -F last_read=1 -F sl=XXXXXXXXXXXXXXXXXX "https://pixplace-ws.pixmania.com/index.php?d=webServices_Server&c=ServerRest" --output recupfic.log

8 PIXPLACE [PixPlace] 3_Import matching par Web services.doc Š FOTOVISTA S.A.S - Reproduction et communication interdites sans autorisation

test  

test ezr ezr ezrezr ez

Read more
Read more
Similar to
Popular now
Just for you