Pour demander votre première API, vous créez l’URL qui pointe vers le « point de terminaison » de l’API qui vous intéresse, puis vous transmettez cette URL à l’action Obtenir le contenu de l’URL. Lorsque le raccourci est exécuté, cette action effectue la requête API.

Une requête API Dark Sky qui contient une action Texte avec une clé API secrète, suivie d’une action URL pointant vers le point de terminaison de l’API, à l’aide d’une variable Clé secrète, suivie d’une action Obtenir le contenu de l’URL.

Effectuer la requête API

Le point de terminaison des prévisions météo (« forecast » en anglais) de Dark Sky nécessite que les demandes d’URL soien formatées comme suit :

https://api.darksky.net/forecast/[VOTRE_CLÉ_SECRÈTE]/[LAT],[LONG]

Le texte entre crochets sera remplacé par une clé API et le lieu pour lequel vous voulez des données prévisionnelles.

Dans l’app Raccourcis, placez votre clé API de Dark Sky dans la première action Texte, qui est utilisée comme variable dans l’action URL. Les données correspondant aux valeurs LAT et LONG sont déjà définies sur 37.8267 et -122.4233, qui sont les coordonnées de l’île d’Alcatraz à San Francisco. Vous pouvez modifier ces valeurs pour indiquer un autre endroit.
Essayez d’utiliser l’action Obtenir le lieu actuel et de la placer dans l’URL en tant que variable magique définie sur Latitude et Longitude dans l’action URL pour obtenir des données météorologiques locales chaque fois que vous exécutez le raccourci.

Exécuter la requête API avec l’action Obtenir le contenu de l’URL

Dans l’éditeur de raccourci de l’app Raccourcis, définissez Obtenir le contenu de l’URL sur Avancé.
Les options suivantes, pour les types de requêtes API que vous pouvez effectuer, deviennent disponibles :
- GET vous permet de récupérer des données.
- POST vous permet de créer de nouvelles données.
- PUT vous permet de mettre à jour des données en les remplaçant.
- PATCH vous permet de mettre à jour des données en les modifiant.
- SUPPRIMER vous permet de supprimer un objet spécifié dans la requête URL.
Pour cet exemple, utilisez une requête GET pour récupérer les données de l’API Dark Sky.
Une fois que l’action URL a reçu votre requête et que l’action Obtenir le contenu de l’URL est définie sur données GET, vous pouvez effectuer la requête API.
Remarque : lorsque l’action Obtenir le contenu de l’URL est configurée sur POST, PUT ou PATCH, un nouveau paramètre du nom de Demander le corps est ajouté. Demander le corps vous permet d’envoyer des données JSON, un formulaire ou un fichier à l’API dans le cadre de votre requête. Ceci vous permet de saisir de nouvelles données manuellement ou en utilisant des variables afin d’envoyer les données à l’API pour créer, remplacer ou modifier une entrée.
Touchez pour tester le raccourci (l’action Coup d’œil dans le raccourci vous permet de prévisualiser les données renvoyées par l’API).
En premier lieu, l’API semble afficher un texte qui n’a aucun sens. Ces données météorologiques sont codées au format JSON, qui est une abréviation de JavaScript Object Notation, le nom d’un format de données textuelles dérivé de la notation des objets du langage JavaScript.

Pour en savoir plus sur l’utilisation du format JSON et pour continuer avec l’exemple de l’API Dark Sky, consultez Introduction à l’utilisation de JSON dans Raccourcis.

Avez-vous trouvé cet article utile ?

Guide de l’utilisateur de Raccourcis

Demander une première API dans Raccourcis

Effectuer la requête API

Exécuter la requête API avec l’action Obtenir le contenu de l’URL