Ensimmäisen API-pyynnön tekeminen Oikoteissä
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 oikotie 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 Oikotiet-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 oikotien, 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 Oikotiet-apin oikotie-editorissa Hae URLin sisältö -toiminnolle Lisävalinnat.
Seuraavat API-pyyntöjen tyypit ovat nyt valittavissa:
GET-pyynnöllä voit hakea dataa APIsta luettavaksi.POST-pyynnöllä voit luoda uutta tietoa.PUT- jaPATCH-pyynnöillä voit päivittää dataa joko korvaamalla tai 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 manuaalisesti tai muuttujien avulla ja voit lähettää datan APIin tietueen luomista, korvaamista tai muokkaamista varten.Testaa oikotietä napauttamalla
(oikotiessä oleva Pikakatsele-toiminto mahdollistaa APIn palauttaman datan esikatselun).
Onnittelut, olet tehnyt ensimmäisen API-pyyntösi käyttämällä Oikoteitä.
Ensinäkemältä API näyttää palauttavan paljon oudon muotoista tekstiä. Lähempi tarkastelu paljastaa, että teksti sisältää sääennustetietoja. Säätiedot on koodattu JSON-muodossa (JavaScript Object Notation).
Jos haluat oppia JSONin käyttöä ja jatkaa Dark Sky API -esimerkin parissa, katso Tietoja JSONin käyttämisestä oikotiessä.