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

418 Я чайник - Любая попытка сварить кофе с помощью чайника должна привести к коду ошибки "418 I'm a teapot". Результирующее тело сущности МОЖЕТ быть коротким и крепким.

  • RFC 2324, Hyper Text Coffee Pot Control Protocol

Не рекомендуется использовать в ответах "голые" коды состояния. DRF включает набор именованных констант, которые вы можете использовать, чтобы сделать ваш код более очевидным и читаемым.

from rest_framework import status
from rest_framework.response import Response

def empty_view(self):
    content = {'please move along': 'nothing to see here'}
    return Response(content, status=status.HTTP_404_NOT_FOUND)

Полный набор кодов состояния HTTP, включенных в модуль status, приведен ниже.

Модуль также включает набор вспомогательных функций для проверки того, находится ли код состояния в заданном диапазоне.

from rest_framework import status
from rest_framework.test import APITestCase

class ExampleTestCase(APITestCase):
    def test_url_root(self):
        url = reverse('index')
        response = self.client.get(url)
        self.assertTrue(status.is_success(response.status_code))

Более подробную информацию о правильном использовании кодов состояния HTTP смотрите в RFC 2616 и RFC 6585.

Информационный - 1xx

Этот класс кода состояния указывает на предварительный ответ. По умолчанию в DRF не используются коды состояния 1xx.

Успешно - 2xx

Этот класс кода состояния указывает на то, что запрос клиента был успешно получен, понят и принят.

Перенаправление - 3xx

Этот класс кода состояния указывает на то, что агенту пользователя необходимо предпринять дополнительные действия для выполнения запроса.

Ошибка клиента - 4xx

Код состояния класса 4xx предназначен для случаев, когда клиент, похоже, ошибся. За исключением ответа на запрос HEAD, сервер ДОЛЖЕН включать объект, содержащий объяснение ситуации с ошибкой, а также то, является ли она временной или постоянной.

Ошибка сервера - 5xx

Коды состояния ответа, начинающиеся с цифры "5", указывают на случаи, когда сервер знает, что он ошибся или не в состоянии выполнить запрос. За исключением ответа на запрос HEAD, сервер ДОЛЖЕН включать объект, содержащий объяснение ситуации с ошибкой, а также то, является ли она временной или постоянной.

Вспомогательные функции

Для определения категории кода ответа доступны следующие вспомогательные функции.

PreviousИсключенияNextТестирование

Last updated

Was this helpful?