![](https://help.apple.com/assets/63A24242BFFB1C67B5512B26/63A24245BFFB1C67B5512B35/ms_MY/389e356d55e928d40def9c16d476e5e0.png)
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.
![Permintaan API yang mengandungi tindakan URL yang menunjuk titik tamat API, diikuti oleh tindakan Dapatkan Kandungan URL.](https://help.apple.com/assets/63A24242BFFB1C67B5512B26/63A24245BFFB1C67B5512B35/ms_MY/4ad53eb22933aae7a55612f7bf800fe9.png)
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
users
akan 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=Bret
mencari 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:
GET
membenarkan anda mengambil data.POST
membenarkan anda mencipta data baru.PUT
membenarkan anda mengemas kini data dengan menggantikannya.PATCH
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 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.