Kaedah HTTP menyatakan niat anda pada satu sumber; kod status ialah jawapan berkod server. Dua sifat penting bagi kaedah: safe (baca-sahaja, tiada kesan sampingan) dan idempotent (mengulanginya menghasilkan keputusan yang sama — penting untuk retry yang selamat).
| Kaedah | Tujuan | Safe | Idempotent |
|---|
| GET | Baca satu sumber | Yes | Yes |
| POST | Cipta / cetus satu tindakan | No | No |
| PUT | Ganti satu sumber | No | Yes |
| PATCH | Kemas kini sebahagian | No | No* |
| DELETE | Buang satu sumber | No | Yes |
| HEAD | Seperti GET, header sahaja | Yes | Yes |
Perbezaan idempotency adalah praktikal: kerana PUT dan DELETE bersifat idempotent, klien boleh dengan selamat retry mereka selepas satu timeout; retry satu POST yang bukan-idempotent berisiko mencipta pendua (pepijat caj-dua-kali klasik).
Kod status dikumpulkan mengikut digit pertamanya:
1xx Informational request received, continuing (100 Continue, 101 Switching)
2xx Success it worked (200 OK, 201 Created, 204 No Content)
3xx Redirection go elsewhere (301 Moved, 304 Not Modified)
4xx Client error YOUR request is wrong (400, 401, 403, 404, 429)
5xx Server error the SERVER failed (500, 502, 503, 504)
Baris yang paling penting ialah pembahagian 4xx berbanding 5xx: 4xx bermakna klien menghantar sesuatu yang salah (input buruk, tidak disahkan, tidak ditemui) — retry tanpa ubah tidak membantu; 5xx bermakna server gagal — retry (dengan backoff) mungkin berjaya. Ketahui yang harian dengan mantap: 401 (tidak disahkan) berbanding 403 (disahkan tetapi tidak dibenarkan), 404 (tidak ditemui), 429 (dihadkan kadar), 500 (crash server generik), 502/503/504 (bad gateway / tidak tersedia / gateway timeout — biasanya masalah upstream atau terlebih beban).
Kod-kod ini ialah kontrak dikongsi antara setiap klien dan server, jadi kefasihan di sini dijangka daripada sesiapa yang membina atau menggunakan API. Penemu duga menduga perbezaan yang mendedahkan kefahaman sebenar: 401 berbanding 403, PUT berbanding PATCH, dan terutamanya idempotency, yang secara langsung mengawal sama ada retry selamat — kebimbangan teras dalam sistem teragih dan aliran pembayaran. Memulangkan kod status yang betul juga menjadikan API anda boleh diramal dan dikendalikan dengan betul oleh cache, proxy, dan pustaka klien, jadi pengetahuan ini membentuk reka bentuk API yang baik, bukan sekadar perkara remeh.
Pustaka soalan temu duga IT dengan jawapan terperinci — daripada Junior hingga Senior.
Derma