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.

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 : Sélectionner tout - Visualiser dans une fenêtre à part
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 : Sélectionner tout - Visualiser dans une fenêtre à part
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 : Sélectionner tout - Visualiser dans une fenêtre à part
1
2
3
4
5
{
  "$schema": "http://json-schema.org/draft-04/schema#",
  "type": "object",
  "properties": {}
}