Ensimmäisen API-pyynnön tekeminen Pikakomennoissa
Luo ensimmäisen API-pyynnön tekemistä varten URL, joka on kohdistettu haluamallesi API-päätepisteelle, ja vie kyseinen URL Hae URLin sisältö -toimintoon. Kun pikakomento suoritetaan, tämä toiminto tekee API-pyynnön.
API-pyynnön tekeminen
Dark Sky -palvelun Forecast-päätepiste edellyttää seuraavan muotoista URL-pyyntöä:
https://api.darksky.net/forecast/[OMA_AVAINTUNNISTEESI]/[LAT],[LONG]
Hakasulkeissa olevan tekstin tilalle täytetään oma API-avaintunniste ja sen paikan sijainti, josta haluat sääennustetiedot.
Sijoita Pikakomennot-apissa Dark Skyltä saamasi API-avaintunniste ensimmäiseen Teksti-toimintoon, joka viedään URL-toimintoon muuttujana. Kohtiin
LATjaLONGon valmiiksi asetettu arvot37.8267ja-122.4233, jotka ovat San Franciscon Alcatrazin saaren koordinaatit. (Voit vaihtaa näiden arvojen tilalle toisen sijainnin.)Jos haluat saada paikalliset säätiedot aina, kun suoritat pikakomennon, voit kokeilla käyttää Hae nykyinen sijainti -toimintoa ja sijoittaa sen taikamuuttujaksi URLin kohtiin Leveysaste (LAT) ja Pituusaste (LONG).
API-pyynnön suorittaminen Hae URLin sisältö -toiminnolla
Valitse Pikakomennot-apin pikakomentoeditorissa Hae URLin sisältö -toiminnolle Lisävalinnat.
Seuraavat API-pyyntöjen tyypit ovat nyt valittavissa:
GET-pyynnöllä voit hakea dataa.POST-pyynnöllä voit luoda uutta tietoa.PUT-pyynnöllä voit päivittää dataa korvaamalla sitä.PATCH-pyynnöllä voit päivittää dataa muokkaamalla sitä.DELETE-pyynnöllä voit poistaa objektin, joka on määritetty URL-pyynnössä.
Käytä tässä esimerkissä
GET-pyyntöä tietojen saamiseen Dark Sky APIsta.Nyt kun URL-toiminto sisältää pyyntösi ja Hae URLin sisältö -toimintoon on asetettu
GET-pyyntö datan saamista varten, olet valmis tekemään API-pyynnön.Huomaa: Jos Hae URLin sisältö -toimintoon vaihdetaan
POST,PUTtaiPATCH, lisätään uusi parametri nimeltä Pyynnön runko. Pyynnön runko -parametrin avulla voit sisällyttää pyynnön osaksi JSON-muotoista dataa, Lomakkeen tai Tiedoston. Näin voit syöttää uutta dataa käsin tai muuttujien avulla ja voit lähettää datan APIin tietueen luomista, korvaamista tai muokkaamista varten.Testaa pikakomentoa napauttamalla
(pikakomennossa oleva Pikakatsele-toiminto mahdollistaa APIn palauttaman datan esikatselun).
Ensinäkemältä API näyttää palauttavan outoa tekstiä. Säätiedot on koodattu JSON-muodossa (JavaScript Object Notation).
Jos haluat oppia JSONin käyttöä ja jatkaa Dark Sky API -esimerkin parissa, katso Johdanto JSONin käyttämiseen Pikakomennoissa.