![](https://help.apple.com/assets/5D66C362680CE25E7861EFB5/5D66C38B680CE25E7861EFC5/id_ID/c10e8a839dc838a25d0feb0e9e428a0a.png)
Meminta API pertama Anda di Pintasan
Untuk meminta API pertama Anda, buat URL yang mengarah pada “titik ujung” API yang Anda inginkan, lalu teruskan URL tersebut ke tindakan Dapatkan Konten URL. Setelah pintasan dijalankan, tindakan ini akan mengajukan permintaan API tersebut.
![Permintaan API Dark Sky yang berisi tindakan Teks dengan kunci API rahasia, diikuti oleh tindakan URL yang mengarah pada titik ujung API menggunakan variabel Kunci Rahasia, diikuti oleh tindakan Dapatkan Konten URL.](https://help.apple.com/assets/5D66C362680CE25E7861EFB5/5D66C38B680CE25E7861EFC5/id_ID/c539926d7e0e8f6b2aa71dd48748d9ab.png)
Membuat permintaan API
Titik Ujung Ramalan Dark Sky mengharuskan agar permintaan URL diformat seperti berikut:
https://api.darksky.net/forecast/[KUNCI_RAHASIA_ANDA]/[LAT],[LONG]
Teks di kurung siku akan diisi dengan kunci API dan lokasi untuk data ramalan yang Anda inginkan.
Di app Pintasan, tempatkan kunci API Anda dari Dark Sky di tindakan Teks pertama, yang diteruskan ke tindakan URL sebagai variabel. Nilai
LAT
danLONG
telah diatur ke37.8267
dan-122.4233
, yang merupakan koordinat untuk Pulau Alcatraz di San Francisco. (Anda dapat memindahkan nilai tersebut ke lokasi baru.)Coba gunakan tindakan Dapatkan Lokasi Saat ini dan tempatkan sebagai Variabel Magic yang diatur ke Garis Lintang dan Garis Bujur di tindakan URL untuk mendapatkan data cuaca lokal setiap kali Anda menjalankan pintasan.
Menjalankan permintaan API dengan tindakan Dapatkan Konten URL
Di editor pintasan app Pintasan, atur Dapatkan Konten URL ke Lanjutan.
Pilihan berikut untuk jenis permintaan API dapat Anda jadikan tersedia:
GET
memungkinkan Anda untuk mengambil data baru.POST
memungkinkan Anda untuk membuat data baru.PUT
memungkinkan Anda untuk memperbarui data dengan menggantinya.PATCH
memungkinkan Anda untuk memperbarui data dengan memodifikasinya.DELETE
memungkinkan Anda untuk menghapus objek yang ditetapkan di permintaan URL.
Untuk contoh ini, gunakan permintaan
DAPATKAN
untuk mengambil data dari API Dark Sky.Setelah tindakan URL memiliki permintaan Anda dan tindakan Dapatkan Konten URL diatur untuk menjalankan
DAPATKAN
data, Anda siap untuk membuat permintaan API.Catatan: Jika Dapatkan Konten URL dialihkan ke
POST
,PUT
, atauPATCH
, parameter baru yang disebut Minta Isi akan ditambahkan. Minta Isi memungkinkan Anda untuk mengirimkan JSON, Formulir, atau File ke API sebagai bagian dari permintaan Anda. Ini memungkinkan Anda untuk memasukkan data baru secara manual atau dengan menggunakan variabel sehingga Anda dapat mengirimkan data ke API untuk membuat, mengganti, atau memodifikasi input.Ketuk
untuk menguji pintasan (tindakan Lihat Cepat di pintasan memungkinkan Anda untuk mempratinjau data yang dikembalikan API).
Saat dilihat untuk pertama kalinya, API tampak mengembalikan teks yang tidak beraturan. Data cuaca ini dikodekan dalam JSON, singkatan dari Notasi Objek JavaScript.
Untuk mempelajari cara menggunakan JSON dan melanjutkan contoh API Dark Sky, lihat Pengantar cara menggunakan JSON di Pintasan.