Service WEB externe

Service WEB externe

Demande : requête HTTP

CLIENT

SERVEUR

DIAPASON déclenche l'appel !

Une réponse est envoyée

Ici on veut connaitre le code postal de la ville de JUILLAN !

Réponse: JSON

DIAPASON envoie une demande, sous forme de requête HTTP à l'application externe

Cette demande est construite dans DIAPASON par une requête REB associée à un service WEB définit dans DIAPASON.

Comment est construite cette requête HTTP ?

Pour savoir comment construire notre demande, il faut se référer à la documentation d'API de l'application qu'on appelle ! Elle nous détaillera toutes les informations à transmettre, et sous quelle forme.

Requête HTTP

Un exemple ?

URL de l'application à contacter (fournie dans leurs specs !)

Ici, on a besoin de connaître le code postal d'une ville qu'on a entrée dans DIAPASON: la ville de JUILLAN. On va donc envoyer une demande à une application qui permet de renvoyer le code postal d'une ville !

Query Parameters : paramètres à fournir à l'application : ils seront ajoutés dans l'URL !

URL : https://vicopo.selfbuild.fr/cherche/

Verbe : POST, GET, POST, PUT, PATCH, DELETE

Query Parameters : JUILLAN

Header : Authentification

Verbe : GET

Body: contenu principal de la demande au format JSON

L'application retourne une réponse à DIAPASON sous forme de JSON

Ce fichier JSON va être récupéré par DIAPASON et interprété dans une requête REB !

A quoi ressemble la réponse envoyée par l'application ?

Réponse

Un exemple ?

Code retour : s'il y a eu une erreur , un code erreur est envoyé !

Ici, on a besoin de connaître le code postal d'une ville qu'on a entrée dans DIAPASON: la ville de JUILLAN. On a transmis le om de la ville à l'application externe, qui nous renvoie son code postal !

Headers

Body: on trouve ici les informations renvoyées par l'application externe au format JSON

Code retour : -

Body : (capture JSON ?)