Documentation API 123imprim
TUTORIEL

API RESTful Partenaires

L'objet de cette documentation est de présenter l'API RESTful de 123IMPRIM permettant aux clients partenaires d'accéder aux configurateurs de nos produits ainsi que de récupérer les prix calculés par les configurations choisies.

API RESTful Espace Partenaires Impression 100% française
Statut. Ce document est une version devant être complétée en fonction de l'avancement du projet.

Introduction

Commençons par un exemple qui illustre l'utilisation de l'interface. Elle utilise le protocol HTTP avec une authentification par token.
Le token doit être inséré dans le header HTTP Authorization et la valeur doit être préfixée par le mot clé "Token" de la façon suivante:
Authorization: Token 9944b09199c62bcf9418ad846dd0e4bbdfc6ee4b
Cet exemple utilise la version 0.2 de l'interface.

Récupération des supports de baches

Le partenaire cherche à connaître l'ensemble des supports possibles pour les baches. La récupération des supports existants se fait par une requête GET sur l'URL suivante :
https://api.123imprim.com/0.2/baches/support?format=json
Le résultat obtenu est alors une structure JSON :
exemple 1
Comme on peut l'imaginer, cette même interface peut être utilisée pour un format XML :
https://api.123imprim.com/0.2/baches/support?format=xml
exemple xml

Récupération des prix d'une bache

Pour avoir le prix d'une bache, il faut au minimum un support et une taille (base et hauteur). La récupération des prix se fait par une requête POST sur l'URL suivante :
https://api.123imprim.com/0.2/baches/prix
Le résulat est alors une liste JSON de prix correspondant aux différents délais possibles. Les prix sont en centimes d'euro.
exemple 2
Si on veut ajouter maintenant des oeillets, il faut obtenir la liste des options possibles pour les oeillets :
https://api.123imprim.com/0.2/baches/oeillet
exemple 3
Pour le prix de la bâche avec des oeillets aux 4 coins :
exemple 4
Dans le cas où une incohérence apparaît sur les paramètres, l'interface renvoit une erreur 400 et un descriptif de la raison de l'erreur :
exemple 5