Demander une première API dans Raccourcis
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.
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
LATetLONGsont déjà définies sur37.8267et-122.4233, quisont 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 :
GETvous permet de récupérer les données d’une API à lire.POSTvous permet de créer de nouvelles données.PUTetPATCHvous permettent de mettre à jour les données en les remplaçant ou en les modifiant, respectivement.SUPPRIMERvous permet de supprimer un objet spécifié dans la requête URL.
Pour cet exemple, utilisez une requête
GETpour 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,PUTouPATCH, 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).
Félicitations, vous avez effectué votre première requête API avec Raccourcis.
Au premier coup d’œil, l’API semble renvoyer beaucoup de texte sous un format étrange. En regardant de plus près, vous pourrez voir que le texte contient des informations sur les prévisions météorologiques. 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 À propos de l’utilisation de JSON dans Raccourcis.