Эндпоинт white-label — это эндпоинт, который реселлер добавляет в API, продаваемый под собственным именем. Это не новая возможность, а несколько уже имеющихся в этом API операций, выстроенных по порядку за одним адресом и одним названием, которые выбрал реселлер. Его клиенты вызывают его так же, как всё остальное, а их ассистенты видят его в списке инструментов рядом с операциями, из которых он собран.
Зачем он реселлеру
Потому что продукт, который он продаёт, обычно не одна операция. «Мы прогреем для вас список» — это поиск, затем реакция на каждый результат, затем приглашение людям, которые их написали, — четыре вызова, которые ассистентам его клиентов приходится выполнять правильно и по порядку, каждый раз. Один эндпоинт — та же работа, названная один раз и описанная словами самого реселлера.
Из чего его можно собрать и из чего нельзя
Только из операций, которые входят в собственный тариф реселлера. Собственный эндпоинт — это короткий путь по купленному API, а не способ его обойти: шаг, называющий что-то вне тарифа, отклоняется при написании эндпоинта, а не при его выполнении.
Условия и циклы разрешены, язык выражений — нет. Значение — это обычный JSON или путь, прочитанный из уже выполненной части запуска, а условие — это сравнение. Ничего не вычисляется, потому что эндпоинт пишет клиент, он сохраняется, а затем выполняется на сервере провайдера с настоящим аккаунтом.
Сколько может потратить один вызов
Цикл означает, что эндпоинт может запросить больше работы, чем кто-либо собирался запрашивать, поэтому у одного запуска есть лимиты: число операций, число итераций и время выполнения. Достичь лимита — это ответ, а не ошибка: в нём сказано, что уже было сделано, потому что отправленное сообщение вернуть нельзя.
Каждый шаг проходит авторизацию как новый запрос, поэтому идентификатор, который создал первый шаг, заново проходит проверку, прежде чем второй сможет им воспользоваться. Составной эндпоинт — не способ обойти проверки, которые несут входящие в него операции, и он расходует тот же бюджет темпа, что и они.
Другая половина: убрать наше
Реселлер может также скрывать операции, которые не хочет предлагать. Скрытие убирает операцию из списка инструментов, манифеста и справочника; маршрут при этом по-прежнему отвечает, поэтому клиент, который уже его вызывает, не ломается из-за изменения, сделанного одной фразой. Реселлер, которому нужно убрать целую область, вместо этого перестаёт предлагать эту область.
Частые вопросы
Может ли ИИ-агент написать такой эндпоинт за меня?
Это обычный путь. Опишите, что эндпоинт должен делать и какими из ваших операций пользоваться, — ассистент напишет шаги и сохранит его. Если он потянется к операции, которой нет в вашем тарифе, эндпоинт будет отклонён с указанием её названия, поэтому неверная догадка исправляется, а не сохраняется.
Обходится ли собственный эндпоинт дороже в работе?
Он стоит столько же, сколько стоят входящие в него операции. Один вызов, выполняющий четыре действия, расходует тот же бюджет темпа, что и четыре вызова, выполняющие их по отдельности, потому что каждый шаг авторизуется и укладывается в темп как отдельный запрос.