FITsociety Help ES

Solucionar mensajes de error de la API

3 min de lectura

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.

¿No funciona una conexión con la API pública? La API devuelve entonces un estado HTTP y una clave de error, por ejemplo 401 con auth.invalid_token. A continuación lees qué significan. Puedes pasar este artículo a tu desarrollador.

Comprueba esto primero

  1. ¿El cliente API sigue activo? Ve a Configuración → Complementos e integraciones → Public API → OAuth clients. ¿El cliente está en Revoked o Disabled? Crea entonces un cliente nuevo.

  2. ¿Se renovó el secreto? Tras Rotate secret, el secreto antiguo y los tokens activos dejan de funcionar. Pide a tu desarrollador que use el secreto nuevo.

  3. ¿El token sigue siendo válido? Un token de acceso es válido durante una hora. Después la conexión debe solicitar un token nuevo.

  4. ¿El cliente tiene los scopes correctos? Los permisos de un cliente existente no se amplían automáticamente. Si necesitas más, crea un cliente nuevo.

Qué significa el estado

  • 400: la solicitud no es correcta, por ejemplo un ID o campo no válido. En un cambio a veces falta la Idempotency-Key (idempotency.required). El desarrollador ajusta la solicitud.

  • 401: no hay un token válido. auth.missing_bearer: no se envió ningún token. auth.invalid_token: el token ha caducado, se revocó o no es correcto. auth.invalid_client: el cliente API ya no existe o está desactivado.

  • 403: el token es válido, pero faltan permisos. scopes.insufficient: falta un scope. scopes.health_consent_required o scopes.private_communication_consent_required: el cliente se creó sin consentimiento para datos de salud o comunicación privada. auth.provider_unavailable: la API pública no está disponible para tu empresa; contacta con el soporte.

  • 404: la dirección o el elemento no existe, o no pertenece a tu empresa.

  • 409: hay un conflicto. Por ejemplo, la misma Idempotency-Key para otra solicitud (idempotency.conflict), una solicitud que aún está en curso (idempotency.in_progress), o un miembro que ya existe (CLIENT_ALREADY_EXISTS_IN_COMPANY).

  • 429: demasiadas solicitudes (rate_limit.exceeded). Cada cliente API puede hacer 10 solicitudes por segundo. Espera los segundos que indica Retry-After y vuelve a intentarlo.

  • 500: un error inesperado en FITsociety (server.internal_error). Inténtalo más tarde.

La API pública no devuelve el estado 422. Los errores de entrada reciben el estado 400.

Errores al solicitar un token

  • invalid_client (401): ID de cliente desconocido o secreto de cliente incorrecto.

  • unauthorized_client (403): el cliente está desactivado o no puede hacer esta solicitud.

  • invalid_scope (400): un scope solicitado no existe o no se asignó a este cliente.

  • invalid_request o unsupported_grant_type (400): la solicitud de token está incompleta o usa un método distinto de client_credentials.

¿Sigue sin funcionar?

Envíanos un mensaje por el chat con el estado HTTP, la clave de error, la hora y el ID de la solicitud (meta.requestId). Nunca envíes tu secreto de cliente ni tu token de acceso.

La lista completa de claves de error está en docs.fitsociety.io. Lee también: Configurar una conexión API y gestionar permisos.

¿Te ha resultado útil este artículo? ¡Gracias por tu opinión!

Gracias, leemos todos los comentarios.

Artículos relacionados