Avant-propos

Dans cet article sur l’utilisation des web services en dehors de lodex, nous allons présenter Hoppscotch et data.page, tous deux utilisables via votre navigateur. Les fichiers que vous choisissez sont ainsi envoyés dans leurs serveurs pour être traités.

Comment utiliser un web service ?

Il y a plusieurs façons plus ou moins similaires d’utiliser des web services (WS) :

  • Via Lodex en faisant des enrichissements (nous n’en parlerons pas dans cet article mais vous pouvez trouver un exemple ici)
  • En ligne de commande sous Linux et Windows (un peu complexe mais utilisable pour les personnes à l’aise avec le code)
  • En utilisant une API web

Quelques pré-requis pour utiliser en ligne de commande ou avec une interface API

Nos web services prennent en entrée un format JSON.
Si vous avez un CSV, vous pouvez faire une transformation grâce au site suivant : https://data.page/. De plus par défaut, les WS s’appliquent sur le champ valeur. Il faut donc au préalable dans votre fichier (CSV, TSV…) ajouter une colonne value de ce que vous voulez enrichir. Il est important de noter que la plupart des WS attendent une structure JSON simple comme par exemple :
[
  {
    "value": "string or object or array o number, etc."
  }
]

Exemple pratique

Je souhaite savoir pour mon fichier en quelle langue sont les résumés de mes livres. Ici je dois lancer le WS de détection de la langue sur la colonne résumé.

Pour cela, je crée une nouvelle colonne avec les données de la colonne résumé uniquement.

Ensuite je transforme mon CSV en JSON (https://data.page/).

Note : Si vous disposez déjà d’un format JSON, vous avez seulement besoin d’ajouter le champ value

1. En ligne de commande

Plus complexe, la ligne de commande est différente selon le système d’exploitation.

Sous Linux :

cat VOTRE_FICHIER_EN_JSON | curl -X POST --data-binary @- "URL DE VOTRE WS"

Sous Windows

(il faut chercher dans la barre de recherche de son menu démarrer, le terminal powerShell)

(cat VOTRE_FICHIER_EN_JSON | wget -Method Post URL DE VOTRE WS).Content

2. Via une API web

Nous proposons d’utiliser une interface web Hoppscotch pour faire l’appel des web services. Pour cela, il faut aller sur le site de hoppscotch.
Ensuite, vous restez dans l’onglet REST et vous choisissez la méthode POST. Vous entrez le lien du WS que vous trouvez sur Objectif TDM.

Pour importer vos données vous devez vous placer dans l’onglet Corps, vous pouvez ensuite :

  1. Soit vous copiez-collez le corps de votre fichier dans le Corps de requête brut
  2. Soit vous importer votre fichier directement depuis le bouton importer

Vous pouvez ensuite télécharger sous format JSON, le résultat du web service :

Une fois le JSON téléchargé, vous pouvez le repasser en CSV pour avoir votre colonne enrichie (qu’il faut bien penser à renommer, ici le nom du WS utilisé à remplacer le nom value).

Conclusion

Et voilà, si vous avez suivi cette procédure, vous avez réussi à enrichir un fichier sans utiliser lodex, ni la ligne de commande !