La demande d'action métier au service web REST se fait au format JSON dans le corps du message.
Paramètre | Balise | Description |
|---|---|---|
Action | "action" | Nom de l'action du service attendue par le service web. |
Paramètres | "param" | Paramètres d'entrée attendus par l'action du service. Dépend de chaque action. |
Token | "access_token" | Valeur du TOKEN obtenu durant la phase d'authentification |
| Info |
|---|
HeaderUn HEADER est uniquement utilisé pour indiqué le Content-Type : application/json , mais pas de header d'authentification puisqu'elle passe par le champ "access_token" du corps |
| Avertissement |
|---|
RappelIl ne faut pas confondre "l'action de service web" et "l'action métier" L'action du service web est celle configurée dans Harmony dans "Actions des services". Elle fait le lien entre un NOM D'ACTION SERVICE et un PROGRAMME DIVA. Ensuite le PROGRAMME DIVA est en général un traitement de routage, qui va utiliser les paramètres afin de déterminer L'ACTION METIER a traiter et les données pour ce traitement Exemple :
|
L'URL a utiliser pour les demandes d'action métier est sous la forme : base commune de l'URL + '/api/v1/WebService/Execute'
...
Exemple d'URL sur un poste local:
http://localhost:8080/DhsDivaltoServiceDivaApiRest/api/v1/WebService/Execute
Exemple d'URL en Divalto cloud:
URL : http http://api.divaltocloud.com/123456/testing1/api/v1/WebService/Execute
Exemple de paramétrage d'action des services Harmony:
...
Exemple de demande d'action de service :
{
"action":"ACADEMY_REST",
"access_token":"eyJhbGciOiJodHRwOi8vd3d3LnczLm9yZy8yMDAxLzA0L3htbGRzaWctbW9yZSNobWFjLNoYTI1NiIsInR5cCI6IkpXVCJ9.eyJpZGVudCI6IkRpdmFsdG9BcGlSZXN0IiwidXNlciI6mJsaXR0ZWwiLCJwYXNzd29yZCI6ImxrajEyMzIxQSIsImVudiI6IkVSUDIxNSIsImRvbWFpbiI6ImRpdmFsdG8iLCJleHAiOiI0DI4MSw0NjYzMTY4NjM0In0.Vx_Qe_WbRhA0qjMOP4tiB-hUnC2lBwsy68GDzzryLhk"
"param":"{ 'items': { 'dos': '998', 'ref': 'BLO0001', 'srefList': { 'srefElem': [ {'sref1': 'XL', 'sref2': 'BLEU'}, {'sref1': 'L' , 'sref2': 'BLANC'}, {'sref1': 'XL', 'sref2': 'BLANC'} ] } }}",
}
=> Fait appel a l'action métier ACADEMY_REST en donnant des paramètres pour effectuer la demande
| Info |
|---|
Le traitement Diva appelé ne reçoit que la zone 'param' transmise par l'appelant. L'enveloppe JSON ainsi que les informations d'authentification sont inconnues du traitement métier |
...
Pour des exemples de demandes et de réponses, il faut se reporter aux chapitres concernant les différents services web métier
| Pages enfant (affichage des enfants) | ||||
|---|---|---|---|---|
|