Cluster · разработчикам

app.requests

Адреса входящих HTTP-запросов к обработчикам loader.request. Bearer-токен является секретом.

Все методы SDK · Типы и ошибки

Получение объекта

endpoint = app.requests("incoming")

__init__

Создаёт Requests. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.

def __init__(app: App) -> None: ...

Аргументы

• app: App, обязательный. Переданный ядром объект app. Второй App в модуле создавать не нужно.

Результат

None. Создаёт Requests. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.

Права

Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.

Ошибки

• Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.

Пример

# Обычный способ получения объекта:
endpoint = app.requests("incoming")

__call__

Создаёт объект адреса входящих запросов для обработчика.

def __call__(handler: str | Callable) -> Endpoint: ...

Аргументы

• handler: str | Callable, обязательный. ID объявленного обработчика либо метод с соответствующим декоратором loader.

Результат

Endpoint. Создаёт объект адреса входящих запросов для обработчика.

Права

Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.

Ошибки

• Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.

Пример

result = app.requests("refresh")

create

Создаёт адрес и токен для обработчика. Не повторяй автоматически при неизвестном результате запроса.

async def create(handler: str | Callable) -> EndpointInfo: ...

Аргументы

• handler: str | Callable, обязательный. ID объявленного обработчика либо метод с соответствующим декоратором loader.

Результат

EndpointInfo. Создаёт адрес и токен для обработчика. Не повторяй автоматически при неизвестном результате запроса.

Права

Нужны requests.manage.

Ошибки

• Ошибки ядра: AccessDenied при нехватке прав или выходе за ограничения, InvalidInput для неверных параметров, InvalidState для недоступного состояния, QuotaExceeded при превышении лимита, Unavailable при недоступной службе. Остальные коды представлены SDKError; см. TYPES.md. Ошибка канала связи вызывает RuntimeError. Действие с неизвестным результатом нельзя автоматически считать невыполненным.

Пример

result = await app.requests.create("refresh")

revoke

Отзывает входящий адрес обработчика.

async def revoke(handler: str | Callable) -> bool: ...

Аргументы

• handler: str | Callable, обязательный. ID объявленного обработчика либо метод с соответствующим декоратором loader.

Результат

bool. True при успешном действии; у отзыва уже отсутствующей записи возможен False.

Права

Нужны requests.manage.

Ошибки

• Ошибки ядра: AccessDenied при нехватке прав или выходе за ограничения, InvalidInput для неверных параметров, InvalidState для недоступного состояния, QuotaExceeded при превышении лимита, Unavailable при недоступной службе. Остальные коды представлены SDKError; см. TYPES.md. Ошибка канала связи вызывает RuntimeError. Действие с неизвестным результатом нельзя автоматически считать невыполненным.

Пример

result = await app.requests.revoke("refresh")