Integración OAuth para partners
Beta. El modo OAuth se está desplegando gradualmente. Contáctanos para registrar tu aplicación.
Si planea integrar ofox en su producto, los usuarios pueden pulsar un botón de OAuth, iniciar sesión y autorizar en ofox, y volver a su aplicación. Los usuarios nuevos que se registran de esta forma se atribuyen automáticamente a su canal de partner, exactamente igual que si se registraran con su enlace de referido.
Cómo integrarlo
Puede solicitarlo aunque la aplicación siga en desarrollo; no hace falta esperar a que el producto esté terminado. La integración OAuth está en fase Beta y el equipo revisa los datos de registro.
- Si aún no forma parte del programa de partners, solicítelo primero en la página Partner ; los partners que ya lo solicitaron o están activados no necesitan volver a hacerlo.
- Envíe los datos de registro indicados abajo a hi@ofox.ai o responda a un correo de soporte existente.
- Tras confirmar los datos de la aplicación, la dirección de redirección y los permisos necesarios, registramos la aplicación OAuth, la vinculamos a su canal de referidos y le facilitamos la configuración de integración.
- Complete la integración OAuth 2.1 en su producto y verifique la autorización, el regreso a la aplicación y las llamadas a modelos.
La atribución del canal no requiere añadir parámetros de referido; la configuramos al registrar la aplicación. La dirección de redirección, los permisos y el flujo de autorización de OAuth deben implementarse según la configuración de integración.
Qué datos necesitamos para registrar la aplicación
La dirección de redirección debe coincidir exactamente con la registrada; no se admiten comodines. Protocolo, dominio, puerto, ruta y la / final deben coincidir. En producción web se recomienda HTTPS. Para escritorio, móvil o desarrollo local, explique el método de redirección al registrarse.
No es necesario enviar el código fuente completo ni un producto terminado para consultar la integración. No envíe contraseñas, API Keys, Client Secrets ni Access Tokens en el correo de solicitud.
Puede copiar la siguiente plantilla y marcar como «por confirmar» lo que aún no esté definido:
Nombre de la aplicación:
Propósito / usuarios:
Tipo de aplicación / ¿tiene backend?:
Dirección de redirección (pruebas):
Dirección de redirección (producción):
Correo de solicitud Partner:
Enlace o código de referido Partner:
Funciones necesarias:
Enlace / descripción del producto (si hay):
Logotipo (si hay):Qué confirmar antes de integrar
- Tipo de cliente: las aplicaciones con backend que pueden guardar secretos de forma segura y las que se ejecutan directamente en el navegador, escritorio o móvil usan configuraciones distintas. Describa la arquitectura real; no incluya el Client Secret en el código frontend ni en instaladores distribuidos a los usuarios.
- Alcance de permisos: solicite solo los permisos que el producto necesita realmente. Llamar a modelos requiere
llm.invoke; el resto se confirma según las necesidades, y los permisos concedidos son los que resulten de la autorización real. - Pruebas de integración: tras el registro, integre según la configuración facilitada; si surge un problema, indique los pasos, el mensaje de error sin datos sensibles y la hora en que ocurrió, sin enviar tokens ni claves.
Qué se atribuye
Solo nuevos registros. Cuando un usuario sin cuenta de ofox pulsa tu botón OAuth, llega a la página de inicio de sesión de ofox, cambia al registro y lo completa — en ese momento se crea la vinculación con tu canal. A partir de ahí, sus recargas y consumo entran en la liquidación normal de comisiones de partner.
Los usuarios que ya tienen una cuenta de ofox conservan su atribución. Autorizar tu aplicación no la cambia — ni siquiera si ese usuario nunca ha estado atribuido a ningún partner. Esto aplica tanto a usuarios ya vinculados a otro partner como a usuarios sin vinculación alguna.
Es deliberado: la vinculación de referidos es permanente y exclusiva durante toda la vida de la cuenta. Permitir la reasignación dejaría que un partner se quedara con los usuarios que trajo otro.
Scope en la primera llamada
El access token que recibes justo después del registro puede no incluir todavía llm.invoke.
llm.invoke solo se concede a usuarios con la dirección de correo verificada. Que eso ya sea cierto en el momento del registro depende de cómo se haya registrado el usuario:
Cuando se elimina un scope, la petición de token sigue teniendo éxito: el campo scope de la respuesta indica lo que se concedió realmente (RFC 6749 §3.3). Lee ese campo en lugar de dar por hecho que obtuviste todo lo solicitado. Llamar a la API de LLM sin llm.invoke devuelve 403 insufficient_scope.
Cuando el usuario verifique su correo, solicita un token nuevo (o refréscalo) y llm.invoke estará incluido.
Comisión
Los usuarios atribuidos se liquidan con la comisión de partner escalonada estándar (hasta el 9 %), según el uso real de la API. Pagos a partir de 50 $, liquidación mensual. Consulta la página de Partners para las condiciones vigentes.