Minta API pertama anda dalam Pintasan pada iPhone atau iPad
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 Typicode memerlukan permintaan URL untuk diformatkan dengan cara ini:
https://jsonplaceholder.typicode.com/[RESOURCE]
Teks dalam kurungan ialah sumber yang anda mahu akses. Typicode memberikan banyak contoh berbeza untuk menguji permintaan. Contoh ini akan menggunakan https://jsonplaceholder.typicode.com/users untuk meminta senarai pengguna.
Dalam app Pintasan
pada peranti iOS atau iPadOS anda, tambahkan permintaan ke URL.Permintaan
usersakan mengembalikan senarai pengguna.Anda boleh memperincikan carian anda dengan menentukan pengguna khusus mengikut id:
https://jsonplaceholder.typicode.com/users/6. Ini akan mengembalikan pengguna dengan id 6.Kebanyakan API membenarkan pertanyaan menggunakan format berikut:
https://jsonplaceholder.typicode.com/users?username=Bret. “?” memulakan pertanyaan, yang mencari item menggunakan pasangan kunci/nilai. Dalam contoh ini, pertanyaan?username=Bretmencari pengguna dengan nama pengguna Bret.Semak dokumentasi API anda untuk carian dan pertanyaan disokong.
Buat permintaan API dengan tindakan Dapatkan Kandungan URL
Dalam app Pintasan
pada peranti iOS atau iPadOS anda, ketik Tunjukkan Lagi dalam tindakan Dapatkan Kandungan URL.Pilihan berikut untuk jenis permintaan API yang anda boleh buat menjadi tersedia:
GETmembenarkan anda mengambil data.POSTmembenarkan anda mencipta data baru.PUTmembenarkan anda mengemas kini data dengan menggantikannya.PATCHmembenarkan 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 Typicode.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.Untuk menguji pintasan, ketik
.
Pada pandangan pertama, API kelihatan mengembalikan teks yang bercampur. Data ini dikodkan dalam JSON, yang bermaksud Notasi Objek JavaScript.
Untuk mengetahui tentang bekerja dengan JSON dan untuk meneruskan dengan contoh API Typicode, lihat Pengenalan kepada menggunakan JSON dalam Pintasan pada iPhone dan iPad.