Meminta API pertama Anda di Pintasan di Mac
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 Typicode mengharuskan permintaan URL untuk diformat dengan cara berikut:
https://jsonplaceholder.typicode.com/[SUMBER DAYA]
Teks dalam tanda kurung adalah sumber daya yang ingin Anda akses. Typicode menyediakan berbagai macam contoh untuk mengetes permintaan. Contoh ini akan menggunakan https://jsonplaceholder.typicode.com/users untuk meminta daftar pengguna.
Di app Pintasan
di Mac Anda, tambahkan permintaan ke URL.Permintaan
usersakan mengembalikan daftar pengguna.Anda dapat mempersempit pencarian dengan menetapkan pengguna secara spesifik menurut id:
https://jsonplaceholder.typicode.com/users/6. Ini akan mengembalikan pengguna yang id-nya adalah 6.Sebagian besar API mengizinkan permintaan yang menggunakan format berikut:
https://jsonplaceholder.typicode.com/users?username=Bret. “?” memulai permintaan, yang mencari item menggunakan pasangan kunci/nilai. Dalam contoh ini, permintaan?username=Bretmencari pengguna yang nama penggunanya adalah Bret.Periksa dokumentasi API Anda untuk pencarian dan permintaan yang didukung.
Menjalankan permintaan API dengan tindakan Dapatkan Konten URL
Di app Pintasan
di Mac Anda, klik Tampilkan Lainnya di Dapatkan Konten tindakan URL.Pilihan berikut untuk jenis permintaan API dapat Anda jadikan tersedia:
GETmemungkinkan Anda untuk mengambil data baru.POSTmemungkinkan Anda untuk membuat data baru.PUTmemungkinkan Anda untuk memperbarui data dengan menggantinya.PATCHmemungkinkan Anda untuk memperbarui data dengan memodifikasinya.DELETEmemungkinkan Anda untuk menghapus objek yang ditetapkan di permintaan URL.
Untuk contoh ini, gunakan permintaan
GETuntuk mengambil data dari API Typicode.Setelah tindakan URL memiliki permintaan Anda dan tindakan Dapatkan Konten URL diatur untuk menjalankan
GETdata, 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.Untuk mengetes pintasan, klik
.
Saat dilihat untuk pertama kalinya, API tampak mengembalikan teks yang tidak beraturan. Data ini dikodekan dalam JSON, singkatan dari Notasi Objek JavaScript.
Untuk mempelajari cara menggunakan JSON dan melanjutkan contoh API Typicode, lihat Pengantar penggunaan JSON di Pintasan di Mac.