Интеграция OAuth для партнёров
Beta. Режим OAuth разворачивается постепенно. Свяжитесь с нами, чтобы зарегистрировать ваше приложение.
Если вы уже интегрировали ofox в свой продукт, пользователи могут авторизоваться через кнопку OAuth, не покидая ваше приложение. Новые пользователи, зарегистрировавшиеся таким образом, автоматически привязываются к вашему партнёрскому каналу — ровно так же, как если бы они зарегистрировались по вашей реферальной ссылке.
Как подключиться
- Свяжитесь с нами, чтобы зарегистрировать ваше приложение.
- Мы создадим OAuth-приложение и привяжем его к вашему реферальному каналу.
- Добавьте кнопку OAuth в свой продукт по стандартному потоку OAuth 2.1.
Кроме стандартного потока OAuth, с вашей стороны настраивать нечего — никаких дополнительных параметров, формата URL или SDK. Привязка канала настраивается на нашей стороне, на сервере.
Что засчитывается
Только новые регистрации. Когда пользователь без аккаунта ofox нажимает вашу кнопку OAuth, он попадает на страницу входа ofox, переключается на регистрацию и завершает её — именно в этот момент создаётся привязка к вашему каналу. Далее его пополнения и расход идут через обычный расчёт партнёрского вознаграждения.
У пользователей с уже существующим аккаунтом ofox привязка не меняется. Авторизация вашего приложения её не изменит — даже если этот пользователь никогда не был привязан ни к одному партнёру. Это касается как пользователей, уже привязанных к другому партнёру, так и пользователей вовсе без привязки.
Это сделано намеренно: реферальная привязка постоянна и эксклюзивна на всё время жизни аккаунта. Разрешив перепривязку, мы позволили бы одному партнёру забрать пользователей, приведённых другим.
Scope при первом вызове
Access token, полученный сразу после регистрации, может ещё не содержать llm.invoke.
llm.invoke выдаётся только пользователям с подтверждённым адресом электронной почты. Подтверждён ли он уже на момент регистрации, зависит от того, каким способом пользователь зарегистрировался:
| Способ регистрации | Почта подтверждена по завершении | llm.invoke в первом token |
|---|---|---|
| Ссылка без пароля | Да — переход по ссылке и есть подтверждение | Выдаётся |
| Почта + пароль | Ещё нет | Отбрасывается до подтверждения |
Если scope отброшен, запрос token всё равно завершается успешно — поле scope в ответе перечисляет то, что было выдано фактически (RFC 6749 §3.3). Читайте это поле, а не исходите из того, что получили всё запрошенное. Вызов LLM API без llm.invoke вернёт 403 insufficient_scope.
После того как пользователь подтвердит почту, запросите новый token (или обновите его) — llm.invoke будет включён.
Вознаграждение
Привязанные пользователи рассчитываются по стандартному многоступенчатому партнёрскому вознаграждению (до 9 %) на основе фактического использования API. Выплаты от $50, расчёт ежемесячный. Актуальные условия — на странице для партнёров .