ULTINEO LOGISTICS

Votre clé d'API et votre premier appel

L'API Ultineo Logistics permet à votre propre logiciel d'ajouter et de lire des colis, de lire le catalogue des transporteurs et de gérer votre carnet d'adresses. Son adresse est https://api.logistic.ultineo.com/v1/.

Créer une clé d'API

  1. Dans l'espace de travail, ouvrez le menu de votre projet et cliquez sur Accès API.
  2. Créez une clé, donnez-lui les scopes dont elle a besoin, puis copiez-la : elle n'est affichée qu'une fois. L'article Clés d'API détaille l'écran.
ScopeDonne
parcel:readlire vos colis et leurs événements de suivi
parcel:writeajouter, modifier, mettre en pause, relancer et supprimer des colis
carrier:readlire le catalogue des transporteurs
address:readlire votre carnet d'adresses
address:writeajouter, modifier et supprimer des adresses

Faire votre premier appel

Envoyez la clé comme jeton bearer :

curl https://api.logistic.ultineo.com/v1/carrier/list?q=UPS \
  -H "Authorization: Bearer VOTRE_CLE"

Chaque réponse est un JSON à trois champs : code (le statut HTTP), title et response. Une liste répond object, total, limit, offset et data ; limit vaut au plus 100.

Lire les erreurs

CodeSignification
400Un champ obligatoire manque : le message le nomme.
401Aucune clé d'API valide fournie.
402Plus de suivi de colis : achetez des suivis ou activez la recharge automatique.
403La clé n'a pas le scope requis : le message le nomme.
404La ressource n'existe pas.
409Déjà présent : la réponse porte l'id du colis ou de l'adresse qui le détient.
413Un lot porte plus de 100 colis.
422Une valeur est refusée : le message dit laquelle et pourquoi.