Cluster · разработчикам
Response
HTTP-ответ с кодом, заголовками и телом. 4xx и 5xx доступны без исключения до raise_for_status().
Все методы SDK · Типы и ошибки
Получение объекта
response = await app.web.get("https://example.org/status")__init__
Создаёт Response. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.
def __init__(data: HTTPResponse) -> None: ...Аргументы
data: HTTPResponse, обязательный. Словарь ядра со status, headers, body и binary.
Результат
None. Создаёт Response. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
# Обычный способ получения объекта:
response = await app.web.get("https://example.org/status")ok
Проверяет, находится ли HTTP-статус в диапазоне 200..299.
def ok() -> bool: ...Свойство: читается без скобок и без await.
Аргументы
Нет.
Результат
bool. Проверяет, находится ли HTTP-статус в диапазоне 200..299.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
value = response.okcontent
Возвращает байты тела, декодируя base64 для бинарного ответа.
def content() -> bytes: ...Свойство: читается без скобок и без await.
Аргументы
Нет.
Результат
bytes. Возвращает байты тела, декодируя base64 для бинарного ответа.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- binascii.Error при неверном base64, UnicodeDecodeError при ошибке кодировки, JSONDecodeError при неверном JSON в соответствующих операциях чтения.
Пример
value = response.contenttext
Декодирует байты ответа выбранной кодировкой.
def text(encoding: str = 'utf-8') -> str: ...Аргументы
encoding: str, по умолчанию'utf-8'. Название кодировки Python для декодирования байтов.
Результат
str. Декодирует байты ответа выбранной кодировкой.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- binascii.Error при неверном base64, UnicodeDecodeError при ошибке кодировки, JSONDecodeError при неверном JSON в соответствующих операциях чтения.
Пример
result = response.text()json
Разбирает тело ответа как JSON в UTF-8.
def json() -> JSON: ...Аргументы
Нет.
Результат
JSON. Разбирает тело ответа как JSON в UTF-8.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- binascii.Error при неверном base64, UnicodeDecodeError при ошибке кодировки, JSONDecodeError при неверном JSON в соответствующих операциях чтения.
- json.JSONDecodeError, если полученная строка не является JSON; UnicodeDecodeError, если байты нельзя декодировать.
Пример
result = response.json()raise_for_status
Возвращает тот же ответ для 2xx, иначе выбрасывает RuntimeError с HTTP-статусом.
def raise_for_status() -> Self: ...Аргументы
Нет.
Результат
Self. Тот же объект после успешной операции. Возвращает тот же ответ для 2xx, иначе выбрасывает RuntimeError с HTTP-статусом.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
RuntimeError(f'HTTP {self.status}'): условие проверяется до продолжения операции.- binascii.Error при неверном base64, UnicodeDecodeError при ошибке кодировки, JSONDecodeError при неверном JSON в соответствующих операциях чтения.
Пример
result = response.raise_for_status()header
Ищет заголовок без учёта регистра. При отсутствии возвращает default.
def header(name: str, default: JSON = None) -> JSON: ...Аргументы
name: str, обязательный. Имя HTTP-заголовка без учёта регистра.default: JSON, по умолчаниюNone. Возвращаемое или исходное значение при отсутствии данных. Объекты JSON копируются.
Результат
JSON. Ищет заголовок без учёта регистра. При отсутствии возвращает default.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- binascii.Error при неверном base64, UnicodeDecodeError при ошибке кодировки, JSONDecodeError при неверном JSON в соответствующих операциях чтения.
Пример
value = response.header("Content-Type", "")