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:
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 :
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
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.
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
Pour le prix de la bâche avec des oeillets aux 4 coins :
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 :