Endpoint dan REST, dengan bahasa sederhana

Endpoint adalah satu item di menu. Ia hanyalah sebuah URL (Uniform Resource Locator) yang melakukan satu hal spesifik. Contohnya:

• https://api.weather.com/forecast — mengambil perkiraan cuaca
• https://api.weather.com/cities — menampilkan daftar kota yang tersedia

Dapur yang sama, hidangan yang berbeda. Setiap endpoint adalah satu kemampuan.

Kebanyakan API yang akan kamu sentuh mengikuti gaya longgar bernama REST (Representational State Transfer). Kamu tidak perlu definisi akademisnya; kamu perlu dua gagasan:

• URL menyebutkan sebuah benda ("resource") — seorang pengguna, sebuah pesanan, sebuah perkiraan cuaca.
• Kata kerja menyatakan apa yang ingin kamu lakukan padanya. Kata kerja ini adalah metode HTTP (HyperText Transfer Protocol), sama seperti yang muncul di bab cara-kerja-web:
  • GET — membaca sesuatu (mengambil perkiraan cuaca). Aman; tidak mengubah apa pun.
  • POST — membuat sesuatu (memesan, mendaftarkan pengguna baru).
  • PUT / PATCH — memperbarui sesuatu yang sudah ada.
  • DELETE — menghapus sesuatu.

Jadi GET /orders/42 berarti "baca pesanan nomor 42," dan DELETE /orders/42 berarti "hapus itu." Kata benda yang sama, kata kerja yang berbeda, efeknya sama sekali berbeda. Saat kamu membaca dokumentasi API atau sebuah diff, dua kata itu — metode dan URL — memberitahumu sebagian besar tentang apa yang dilakukan sebuah permintaan.