Minta API pertama anda dalam Pintasan
Untuk meminta API anda, cipta URL yang menunjuk ke “titik tamat” API yang anda mahu bercakap dengannya dan kemudian serahkan URL tersebut kepada tindakan Dapatkan Kandungan URL. Apabila pintasan dijalankan, tindakan ini membuat permintaan API.
Bina permintaan API
Titik tamat Ramalan Dark Sky memerlukan permintaan URL diformatkan seperti berikut:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
Teks dalam kurungan akan diisi dengan kunci API dan lokasi yang anda mahukan data ramalan.
Dalam app Pintasan, letakkan kunci API anda daripada Dark Sky dalam tindakan Teks pertama, yang diserahkan kepada tindakan URL sebagai pemboleh ubah. Nilai
LATdanLONGsudah disetkan kepada37.8267dan-122.4233, iaitukoordinat Pulau Alcatraz Island di San Francisco. (Anda boleh menukar nilai tersebut ke lokasi berlainan.)Cuba gunakan tindakan Dapatkan Lokasi Semasa dan letakkannya sebagai Pemboleh Ubah Pintar yang disetkan kepada Latitud dan Longitud dalam tindakan URL untuk mendapatkan data cuaca setempat apabila anda menjalankan pintasan.
Buat permintaan API dengan tindakan Dapatkan Kandungan URL
Dalam editor pintasan app Pintasan, setkan Dapatkan Kandungan URL ke Lanjutan.
Pilihan berikut untuk jenis permintaan API yang anda boleh buat menjadi tersedia:
DAPATKANmembenarkan anda mengambil data.POSTmembenarkan anda mencipta data baru.LETAKKANmembenarkan anda mengemas kini data dengan menggantikannya.TAMPALmembenarkan anda mengemas kini data dengan mengubah suainya.DELETEmembenarkan anda mengeluarkan objek yang ditentukan dalam permintaan URL.
Untuk contoh ini, gunakan permintaan
GETuntuk mendapatkan data daripada API Dark Sky.Kini tindakan URL mempunyai permintaan anda dan tindakan Dapatkan Kandungan URL disetkan ke data
GET, anda sedia untuk membuat permintaan API.Nota: Apabila tindakan Dapatkan Kandungan URL ditukar kepada
POST,PUT, atauPATCH, parameter baru yang dipanggil Minta Isi ditambah. Minta Isi membenarkan anda menghantar JSOn, Borang atau Fail kepada API sebagai sebahagian daripada permintaan anda. Ini membenarkan anda memasukkan data secara manual atau dengan menggunakan pemboleh ubah supaya anda boleh menghantar data kepada API untuk mencipta, mengganti atau mengubah suai entri.Ketik
untuk menguji pintasan (tindakan Lihat Cepat dalam pintasan membenarkan anda pratonton data yang dikembalikan oleh API).
Pada pandangan pertama, API kelihatan mengembalikan teks yang bercampur. Data cuaca ini dikodkan dalam JSON, yang bermakna Notasi Objek JavaScript.
Untuk mengetahui tentang bekerja dengan JSON dan untuk meneruskan dengan contoh API Dark Sky, lihat Pengenalan kepada penggunaan JSON dalam Pintasan.