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.
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
LATdanLONGtelah diatur ke37.8267dan-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:
GETmemungkinkan Anda untuk mengambil data dari API untuk dibaca.POSTmemungkinkan Anda untuk membuat data baru.PUTdanPATCHmemungkinkan Anda untuk memperbarui data dengan mengganti atau memodifikasinya secara terpisah.DELETEmemungkinkan Anda untuk menghapus objek yang ditetapkan di permintaan URL.
Untuk contoh ini, gunakan permintaan
DAPATKANuntuk mengambil data dari API Dark Sky.Setelah tindakan URL memiliki permintaan Anda dan tindakan Dapatkan Konten URL diatur untuk menjalankan
DAPATKANdata, 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).
Selamat, Anda telah membuat permintaan API pertama Anda menggunakan Pintasan.
Saat dilihat untuk pertama kalinya, API tampak mengembalikan banyak teks berformat aneh. Jika dilihat lebih dekat, Anda dapat melihat bahwa teks berisi informasi ramalan cuaca. Data cuaca ini dikodekan dalam JSON, singkatan dari Notasi Objek JavaScript.
Untuk mempelajari cara menggunakan JSON dan melanjutkan contoh API Dark Sky, lihat Mengenai cara menggunakan JSON di Pintasan.