Documentación técnica: todas las rutas, permisos y ejemplos actuales de la API están en docs.fitsociety.io. Si eres desarrollador, empieza por la guía de inicio rápido de Public API.
¿Trabajas con un desarrollador externo? Acordad previamente qué sistema conectar, qué datos se necesitan, qué acciones podrá realizar la conexión y quién la gestionará. Pide al administrador que cree el cliente en la empresa correcta. Facilita al desarrollador el enlace a la documentación y solo los datos de conexión necesarios mediante un canal seguro; no compartas tu contraseña de coach. Utiliza un cliente independiente por integración para poder revocar después cada acceso por separado.
Un cliente de API es el acceso de una integración externa dentro de tu empresa. Lo crea un administrador autorizado. Tu desarrollador utiliza el ID y el secreto del cliente para configurar técnicamente la conexión.
En este artículo
1. Crea un cliente de API
Selecciona la empresa correcta en el panel de entrenador.
Ve a Configuración → Plugins e integraciones → Public API.
Abre Clientes OAuth y elige Añadir cliente de API.
Introduce un nombre reconocible, como “Integración CRM”, y revisa los scopes seleccionados.
Acepta únicamente los consentimientos de datos necesarios para esta integración y elige Crear cliente.
Copia el ID del cliente y el secreto que se muestra una sola vez. Guárdalos de forma segura y entrégalos al desarrollador de forma protegida.
Usa un cliente distinto por integración. No compartas tu contraseña de entrenador ni incluyas secretos en mensajes de soporte o código público.
2. Elige solo los permisos necesarios
Los scopes determinan qué puede hacer la integración. Por ejemplo, clients:read permite consultar datos de clientes; clients:write da acceso a las acciones de escritura admitidas. Revisa la selección inicial: el acceso de solo lectura no está activado automáticamente para cada nueva integración.
Los datos de salud y las comunicaciones privadas requieren consentimiento explícito adicional. La automatización de estados de toda la empresa tiene permisos propios: client_status_automation:read y client_status_automation:write. Poder modificar solo clientes no concede este último permiso.
Los permisos de los clientes de API existentes no se amplían automáticamente. ¿Quieres usar otros scopes? Crea en esta pantalla un nuevo cliente con los permisos deseados, pide al desarrollador que cambie la conexión y después revoca el cliente anterior.
3. Haz que se compruebe la conexión
El desarrollador intercambia las credenciales mediante OAuth por un token de acceso temporal. Ese token es válido durante una hora. Empieza con una consulta de lectura, por ejemplo el perfil del cliente de API, siguiendo la guía técnica de inicio rápido.
La API pública no tiene un sandbox independiente. Las acciones de escritura afectan a datos reales de la empresa. Comprobad juntos primero un proceso acordado antes de automatizar más acciones.
4. Renovar, revocar o resolver un error
Renovar el secreto: úsalo si el secreto se ha perdido o se ha filtrado. Las credenciales anteriores y los tokens de acceso activos quedan invalidados; actualiza la integración de inmediato.
Revocar: detiene este cliente de API e invalida los tokens activos. No se puede deshacer; para una nueva conexión, crea un nuevo cliente.
401: pide que se revisen el token y las credenciales.
403: revisa los scopes, el consentimiento de datos y el acceso de la empresa.
429: la integración envía demasiadas solicitudes; el desarrollador debe respetar el tiempo de espera.
¿Necesitas ayuda? Comparte con soporte el código de error, la hora y, si lo tienes, el ID de solicitud, sin secretos ni tokens de acceso.
Más información
Documentación técnica para tu desarrollador (en inglés)