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