Endpoint adalah URL yang bisa diakses untuk melakukan operasi tertentu.
Anatomy of a URL:
https://api.example.com/v1/users/42?fields=name,email
│ │ │ │ │ │
protocol host version resource query string
│
path parameter
RESTful naming conventions:
/users → Koleksi user
/users/42 → User dengan ID 42
/users/42/posts → Post milik user 42
/users/42/posts/5 → Post #5 milik user 42
Aturan penamaan:
- Gunakan noun (kata benda), bukan verb:
/usersbukan/getUsers - Gunakan plural:
/usersbukan/user - Gunakan kebab-case:
/user-profilesbukan/userProfiles - Jangan masukkan verb: method sudah menentukan aksi
Contoh CRUD endpoints:
| Method | Endpoint | Aksi |
|---|---|---|
| GET | /products | List semua produk |
| GET | /products/5 | Detail produk #5 |
| POST | /products | Buat produk baru |
| PUT | /products/5 | Update produk #5 |
| DELETE | /products/5 | Hapus produk #5 |
Query string untuk filter/sort/paginate:
GET /products?category=electronics&sort=price&order=desc&page=2&limit=10