Cluster · разработчикам
Endpoint
Входящий HTTP-адрес обработчика. Токен не сохраняй в публичных сообщениях и журнале.
Все методы SDK · Типы и ошибки
Получение объекта
endpoint = app.requests("incoming")endpoint указывает на объявленный loader.request обработчик; для чтения headers уже выполнен create().
__init__
Создаёт Endpoint. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.
def __init__(requests: Requests, callback: str | Callable) -> None: ...Аргументы
requests: Requests, обязательный. Служба входящих запросов текущего приложения.callback: str | Callable, обязательный. Обработчик loader.request либо его ID; не callback кнопки.
Результат
None. Создаёт Endpoint. Обычный способ получения объекта показан выше; прямой конструктор не выполняет сетевые запросы.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
- Отдельного исключения SDK нет. Действуют обычные ошибки типов Python и ошибки переданных функций, если они используются.
Пример
# Обычный способ получения объекта:
endpoint = app.requests("incoming")create
Создаёт адрес с токеном один раз. После успешного создания возвращает тот же объект без смены токена.
async def create() -> Self: ...Аргументы
Нет.
Результат
Self. Тот же объект после успешной операции. Создаёт адрес с токеном один раз. После успешного создания возвращает тот же объект без смены токена.
Права
Нужны requests.manage.
Ошибки
RuntimeError('The key creation outcome is unknown; rotate it explicitly'): условие проверяется до продолжения операции.- Ошибки ядра: AccessDenied при нехватке прав или выходе за ограничения, InvalidInput для неверных параметров, InvalidState для недоступного состояния, QuotaExceeded при превышении лимита, Unavailable при недоступной службе. Остальные коды представлены SDKError; см. TYPES.md. Ошибка канала связи вызывает RuntimeError. Действие с неизвестным результатом нельзя автоматически считать невыполненным.
Пример
result = await endpoint.create()rotate
Явно создаёт новый токен и адрес для обработчика, заменяя прежние.
async def rotate() -> Self: ...Аргументы
Нет.
Результат
Self. Тот же объект после успешной операции. Явно создаёт новый токен и адрес для обработчика, заменяя прежние.
Права
Нужны requests.manage.
Ошибки
- Ошибки ядра: AccessDenied при нехватке прав или выходе за ограничения, InvalidInput для неверных параметров, InvalidState для недоступного состояния, QuotaExceeded при превышении лимита, Unavailable при недоступной службе. Остальные коды представлены SDKError; см. TYPES.md. Ошибка канала связи вызывает RuntimeError. Действие с неизвестным результатом нельзя автоматически считать невыполненным.
Пример
result = await endpoint.rotate()headers
Возвращает Authorization: Bearer для созданного адреса. До create() недоступно.
def headers() -> dict[str, str]: ...Свойство: читается без скобок и без await.
Аргументы
Нет.
Результат
dict[str, str]. Возвращает Authorization: Bearer для созданного адреса. До create() недоступно.
Права
Не требует прав: операция выполняется локально и сама не обращается к ядру. Права понадобятся при отправке, сохранении или чтении через службу.
Ошибки
ValueError('The endpoint has not been created'): условие проверяется до продолжения операции.
Пример
value = endpoint.headersrevoke
Отзывает адрес и очищает токен локального объекта.
async def revoke() -> bool: ...Аргументы
Нет.
Результат
bool. True при успешном действии; у отзыва уже отсутствующей записи возможен False.
Права
Нужны requests.manage.
Ошибки
- Ошибки ядра: AccessDenied при нехватке прав или выходе за ограничения, InvalidInput для неверных параметров, InvalidState для недоступного состояния, QuotaExceeded при превышении лимита, Unavailable при недоступной службе. Остальные коды представлены SDKError; см. TYPES.md. Ошибка канала связи вызывает RuntimeError. Действие с неизвестным результатом нельзя автоматически считать невыполненным.
Пример
result = await endpoint.revoke()