HTTP status code-ები ჯგუფდება ხუთ კლასად პირველი ციფრის მიხედვით, და სწორის არჩევა client-ებს საშუალებას აძლევს სწორად მოახდინონ რეაქცია body-ის დამუშავების გარეშე.
2xx Success — the request worked
3xx Redirection — further action / resource moved
4xx Client error — the caller did something wrong
5xx Server error — the server failed
2xx
200 OK — ზოგადი წარმატება (GET, PUT, PATCH).201 Created — resource შეიქმნა (დააბრუნეთ Location header).202 Accepted — მიღებულია ასინქრონული დამუშავებისთვის, ჯერ არ დასრულებულა.204 No Content — წარმატება body-ის გარეშე (გავრცელებული DELETE-ისთვის).4xx
400 Bad Request — დამახინჯებული სინტაქსი ან არასწორი input.401 Unauthorized — არააუთენტიფიცირებული (credential არ არის/არასწორია).403 Forbidden — აუთენტიფიცირებული, მაგრამ ნებადაურთველი.404 Not Found — resource არ არსებობს.409 Conflict — კონფლიქტი მიმდინარე state-თან (მაგ. დუბლირებული email).422 Unprocessable Entity — კარგად ფორმირებული, მაგრამ validation-ს ვერ გადის.429 Too Many Requests — rate limit-ია დაწესებული.5xx
500 Internal Server Error — server-ის მოულოდნელი ხარვეზი.503 Service Unavailable — დროებით გამორთული/გადატვირთული.POST /users → 201 Created
Location: /users/42
DELETE /users/42 → 204 No Content
GET /users/999 → 404 Not Found
{ "error": "user not found" }
მთავარი განსხვავება, რომელსაც ინტერვიუერები ჩხრეკენ: 401 („შენ ვინ ხარ?") vs 403 („გიცნობ, მაგრამ არა"), და 400 (ცუდი სინტაქსი) vs 422 (სწორი სინტაქსი, არასწორი მონაცემი).
Status code-ები არის მთავარი სიგნალი REST response-ში — client-ები, proxy-ები, monitoring და retry ლოგიკა ყველა მათზეა დამოკიდებული, ამიტომ მათი სწორად გაკეთება აუცილებელია თავსებადობისთვის. გავრცელებული ხარვეზია 200 OK-ის დაბრუნება { "error": ... } body-თ: ის აიძულებს ყოველ client-ს body დაამუშაოს იმის გასაგებად, გამოძახება წარმატდა თუ არა, ანგრევს ზოგად HTTP tooling-ს და მალავს ხარვეზებს monitoring-ისგან. ზუსტი code-ები ასევე ავტომატურ ქცევას განაპირობებს: 429 ან 503 კარგად აშენებულ client-ს ეუბნება, უკან დაიხიოს და გაიმეოროს, ხოლო 4xx ამბობს „ნუ გაიმეორებ, გაასწორე request". ინტერვიუერები ამ კითხვას იყენებენ იმის შესამოწმებლად, გესმით თუ არა HTTP როგორც კონტრაქტი და არა როგორც სულელი ტრანსპორტი, და გამოარჩევთ თუ არა დახვეწილ წყვილებს (401/403, 400/422) სწორად — ნიშანი ადამიანისა, ვინც რეალური API-ები ააშენა და გამოიყენა.
IT გასაუბრების კითხვების ბიბლიოთეკა დეტალური პასუხებით — Junior-დან Senior-მდე.
შემოწირულობა