![](https://help.apple.com/assets/5E8CEA35094622DF10489984/5E8CEA42094622DF1048998D/ms_MY/c10e8a839dc838a25d0feb0e9e428a0a.png)
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.
![Permintaan API Dark Sky yang mengandungi tindakan Teks dengan kunci API rahsia, diikuti tindakan URL yang menunjuk ke titik akhir API menggunakan pemboleh ubah Kunci Rahsia, diikuti tindakan Dapatkan Kandungan URL.](https://help.apple.com/assets/5E8CEA35094622DF10489984/5E8CEA42094622DF1048998D/ms_MY/19748d2be730e146ae93ae8d967dc335.png)
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
LAT
danLONG
sudah disetkan kepada37.8267
dan-122.4233, iaitu
koordinat 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:
DAPATKAN
membenarkan anda mengambil data.POST
membenarkan anda mencipta data baru.LETAKKAN
membenarkan anda mengemas kini data dengan menggantikannya.TAMPAL
membenarkan anda mengemas kini data dengan mengubah suainya.DELETE
membenarkan anda mengeluarkan objek yang ditentukan dalam permintaan URL.
Untuk contoh ini, gunakan permintaan
GET
untuk 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.