Utiliser l'api de suivi de la Poste avec VBA (requête curl, uri ect)
Hello tout le monde, est il possible d'utiliser ce genre d'Api avec VBA ?
J'ai trouvé de la docu mais je ne comprends absolument rien, ne sachant faire que des requêtes http.
J'ai bien une X-Okapi-Key et tout le reste mais je m'arrache le peu de cheveux qui me reste pour comprendre le comment du comment. :calim2:
Encore merci pour votre aide.
https://developer.laposte.fr/help
URI des ressources
Chaque ressource API est localisée par son URI.
Format des URI :
Les ressources API sont exposées avec un chemin d'URI qui respecte le format suivant :
https://api.laposte.fr/[produitAPI]/[version]/[cheminRessource]
Le chemin d'URI est donc composé des éléments suivants :
nom du fournisseur d'API (exemple : superapi)
version de l'API (exemple : v1)
chemin de la ressource (exemple : chemin/ressource)
Exemple d'URI :
https://api.laposte.fr/superapi/v1/chemin/ressource
Authentification
Pour pouvoir utiliser les API de La Poste, votre application doit au préalable s'authentifier.
L'authentification basée sur une clé d'API utilisée dans tous les appels API.
Pour obtenir vos clés :
identifiez-vous avec votre compte ou inscrivez-vous
puis accédez à vos applications
Exemple de requête cURL
curl https://api.laposte.fr/suivi/v1/1231231231231
-H "X-Okapi-Key: xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Exemple de résultat :
Code:
1
2
3
4
5
| {
"attr1": "value1",
"attr2": "value2",
"attr3": "value3"
} |
https://developer.laposte.fr/products/suivi/latest
Récupérer le statut d'un colis
GET/suivi/v1/{code}
Cette action retourne l’état du suivi.
Dans la réponse, un attribut \”date\” du dernier statut est retournée au format JJ/MM/AAAA ainsi qu’un attribut \”status\” à utiliser pour une analyse programmatique, l’attribut \”message\” étant plutôt réservé à la communication vers l’utilisateur.
L’information du code statut n’est actuellement pas fournie par le système d’information original, elle a été ajoutée par la plateforme Open API pour satisfaire aux besoins des développeurs, néanmoins sa qualité est imparfaite et il est possible de constater des anomalies (statut inconnu, …)
Cette situation sera corrigée dans une prochaine version.
Le code statut supporte les valeurs suivantes :
PRIS_EN_CHARGE : le colis est pris en charge, ou en cours de traitement
EN_LIVRAISON : le colis est en cours de livraison, d’acheminement, ou prêt à être expédié
EXPEDIE : le colis est expédié
A_RETIRER : le colis est disponible, prêt à être retiré au point de retrait
TRI_EFFECTUE : le colis a été trié
DISTRIBUE : le colis a été distribué
LIVRE : le colis a été livré
DESTINATAIRE_INFORME : le destinataire a été informé
RETOUR_DESTINATAIRE : le colis a été retourné
ERREUR : la livraison du colis est en erreur
INCONNU : le statut est inconnu (une anomalie est possible)
Paramètres
code string(requis) Exemple: 1111111111111
Requête
EnTêtes
X-Okapi-Key: zchl9IRQIeGObF+kw+s4nD4h+d6pJKqgGMwJtT7KFJs/sGa4p1ljEh8hU1zwNcaV
Réponse 200
EnTêtes
Content-Type: application/json; charset=utf-8
Corps
Code:
1
2
3
4
5
6
7
8
| {
\"code\": \"1111111111111\",
\"date\": \"06/03/2016\",
\"status\": \"PRIS_EN_CHARGE\",
\"message\": \"Envoi pris en charge par Chronopost chez l'expéditeur\",
\"link\": \"http://www.chronopost.fr/expedier/inputLTNumbersNoJahia.do?lang=fr_FR&listeNumeros=1111111111111\",
\"type\": \"Chronopost\"
} |
Schéma
Code:
1
2
3
4
5
| {
"$schema": "http://json-schema.org/draft-04/schema#",
"type": "object",
"properties": {}
} |
