Documentation en ligne

Appeler l’API depuis un logiciel ne gérant que les données « plates »

Aperçu

Certains logiciels n’envoient que des données JSON plates, c’est-à-dire que les données composées que d’un seule niveau, l’imbrication de dictionnaire ou de liste n’étant pas autorisées. C’est par exemple le cas de w.c.s. qui dans sa syntaxe de gabarit Django ne tolère pas l’imbrication de données.

Des données plus complexes peuvent être ré-assemblées par authentic à l’aide du caractère ‘/’ présent dans les clés de dictionnaire JSON transmis à authentic.

Si l’élément à droite du ‘/’ dans la clé est un nombre, alors celui-ci correspond à l’index du sous-élément dans la liste décrite. À l’inverse, s’il s’agit d’une chaîne de caractère quelconque, alors celle-ci correspond à la clé du sous-élément dans le dictionnaire décrit.

Par exemple, l’appel

{
    "a/b/c": "e",
    "b/0": 1,
    "b/1": 2
}

correspond à l’élément composé suivant

{
    "a": {"b": {"c": "e"}},
    "b": [1, 2]
}

Utilisation dans les appels Webservice vers Authentic

Cette syntaxe est tout particulièrement utile pour le remplacement des expressions Python dans les appels Webservice faits vers Authentic.

Par exemple, l’envoi de données composées sous la forme Python (en cours de dépréciation) suivante :

peut être remplacé comme ci-dessous :

Dernière mise à jour le 4 janvier 2023 10:17 — Éditer