HTTP method-ები აცხადებენ თქვენს განზრახვას resource-ზე; status code-ები არის სერვერის დაშიფრული პასუხი. method-ებისთვის ორი თვისებაა მნიშვნელოვანი: safe (მხოლოდ წაკითხვა, side effect-ების გარეშე) და idempotent (მისი გამეორება ერთსა და იმავე შედეგს იძლევა — მნიშვნელოვანია უსაფრთხო retry-ებისთვის).
| Method | დანიშნულება | Safe | Idempotent |
|---|
| GET | resource-ის წაკითხვა | Yes | Yes |
| POST | შექმნა / ქმედების გაშვება | No | No |
| PUT | resource-ის ჩანაცვლება | No | Yes |
| PATCH | ნაწილობრივი განახლება | No | No* |
| DELETE | resource-ის მოცილება | No | Yes |
| HEAD | როგორც GET, მხოლოდ header-ები | Yes | Yes |
idempotency-ის განსხვავება პრაქტიკულია: რადგან PUT და DELETE idempotent-ია, კლიენტს შეუძლია მათი უსაფრთხოდ retry timeout-ის შემდეგ; არა-idempotent POST-ის retry-ს დუბლიკატის შექმნის რისკი აქვს (კლასიკური ორმაგი დარიცხვის ბაგი).
Status code-ები დაჯგუფებულია პირველი ციფრით:
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)
ყველაზე მნიშვნელოვანი ხაზი არის 4xx vs 5xx გაყოფა: 4xx ნიშნავს, რომ კლიენტმა არასწორი რამ გააგზავნა (ცუდი input, არაავთენტიფიცირებული, ვერ მოიძებნა) — უცვლელი retry არ დაეხმარება; 5xx ნიშნავს, რომ სერვერი ჩავარდა — retry (backoff-ით) შეიძლება წარმატებული იყოს. ყოველდღიურები ზეპირად იცოდეთ: 401 (არაავთენტიფიცირებული) vs 403 (ავთენტიფიცირებული, მაგრამ არ ეშვება), 404 (ვერ მოიძებნა), 429 (rate limited), 500 (ზოგადი სერვერის crash), 502/503/504 (bad gateway / მიუწვდომელი / gateway timeout — ჩვეულებრივ upstream ან გადატვირთვის პრობლემა).
ეს კოდები საერთო კონტრაქტია ყველა კლიენტსა და სერვერს შორის, ამიტომ აქ თავისუფლად ფლობა მოეთხოვება ყველას, ვინც API-ებს ქმნის ან იყენებს. ინტერვიუერები იკვლევენ იმ განსხვავებებს, რომლებიც რეალურ გაგებას ცხადყოფენ: 401 vs 403, PUT vs PATCH და განსაკუთრებით idempotency, რომელიც პირდაპირ არეგულირებს, უსაფრთხოა თუ არა retry-ები — ძირითადი საკითხი განაწილებულ სისტემებსა და გადახდის ნაკადებში. სწორი status code-ის დაბრუნება ასევე თქვენს API-ს პროგნოზირებადს ხდის და cache-ების, proxy-ებისა და კლიენტის ბიბლიოთეკების მიერ სწორად დამუშავებულს, ამიტომ ეს ცოდნა კარგ API დიზაინს აყალიბებს და არა უბრალოდ წვრილმანია.
IT გასაუბრების კითხვების ბიბლიოთეკა დეტალური პასუხებით — Junior-დან Senior-მდე.
შემოწირულობა