
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.
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 !