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.
En este artículo
El módulo API de la app de FITsociety en Make está pensado para escenarios avanzados en los que quieres usar directamente una ruta compatible de la Public API. Para acciones habituales, como actualizar un miembro o crear una reserva, los módulos de acción de FITsociety disponibles suelen ser más sencillos.
El módulo API usa la misma conexión, la misma empresa y los mismos permisos que tus otros módulos. No da acceso adicional a los datos. Necesitas acceso a la app de FITsociety; pide la app privada al equipo de soporte si aún no está disponible en tu cuenta de Make.
Preparar una solicitud de lectura
Busca la descripción actual de la ruta de la FITsociety Public API que quieres usar.
Comprueba el método HTTP, la ruta, los permisos necesarios y los campos de entrada.
Añade el módulo API y selecciona la conexión con la empresa correcta.
Para una solicitud de lectura, elige GET e introduce la ruta relativa según la ayuda del módulo.
Añade los parámetros de consulta necesarios en los campos previstos para ello.
Haz clic en Run once y comprueba el contenido de la respuesta y el código de estado.
Una prueba de conexión usa la ruta de la Public API GET /public/v1/me. Qué parte de ella introduces en el módulo depende de la ruta base que el módulo ya usa. Sigue la ayuda del módulo y no introduzcas sin más una URL completa del sitio web ni una ruta del entorno del coach.
La autenticación se realiza a través de la conexión seleccionada. No copies un token de acceso de otra integración en tu escenario. Una conexión que funciona solo da acceso a las rutas para las que se ha concedido consentimiento.
Una solicitud que modifica datos
Usa solo un método de escritura que admitan tanto el módulo como la ruta de la API correspondiente. Indica un identificador de origen estable en el campo previsto para ello, como Source operation key. Mantén el mismo valor y la misma entrada al repetir el mismo cambio.
Un cuerpo JSON debe contener JSON válido. Los números usan en él un punto como separador decimal, por ejemplo 172.5. No uses unidades ni importes con formato. Los campos de fecha sin hora usan YYYY-MM-DD; las marcas de tiempo siguen el formato con zona horaria que exige la API.
Al mapear texto libre, usa un generador de JSON para que las comillas y los saltos de línea se procesen correctamente. Prueba las acciones de escritura con datos ficticios. Una solicitud correcta puede provocar cambios, notificaciones y otros efectos normales.
Comprobar resultados y varias páginas
Comprueba en el contenido de la respuesta si se ha encontrado o modificado el registro previsto. Un código de estado correcto por sí solo no indica si tu escenario ha procesado todos los registros deseados.
No des por hecho que un módulo API obtiene automáticamente todas las páginas. Usa la paginación que admiten la ruta y el módulo, y comprueba si hay más resultados. Pide al equipo de soporte de FITsociety la documentación adecuada si no sabes con seguridad qué ruta, permisos o paginación corresponden a tu objetivo.
¿Aún no tienes conexión? Lee Conectar FITsociety con Make.