Коды состояния

Каждый ответ начинается с трёхзначного кода, и первая цифра говорит, кого винить:

• 2xx — всё прошло успешно. 200 OK, 201 Created.
• 3xx — перейдите куда-то ещё. 301 перемещено навсегда, 302 найдено.
• 4xx — запрос был составлен неправильно. 404 не найдено, 401 не авторизован, 403 запрещено.
• 5xx — сервер сломался. 500 внутренняя ошибка, 503 недоступен.

Разделение на 4xx и 5xx — самое полезное. 4xx — это ваша вина, поэтому исправьте запрос: неправильный путь, отсутствующий токен, неверные данные. 5xx — это их вина, поэтому повторная попытка может помочь, а изменение запроса — нет.

Помните, что 404 — это вполне успешный запрос. Соединение сработало, сервер понял запрос, и его ответ был: «такой вещи нет». curl завершается с кодом 0.