Maneja errores y reintentos de la API

Siempre inspecciona el estado HTTP antes de leer una respuesta como exitosa. Los servicios de ShareAI pueden devolver diferentes envolturas de error: la inferencia puede proporcionar error.code, OAuth proporciona error and error_description, y las rutas de la Consola pueden devolver code, message and data.status.

Estado	Significado típico	Recuperación
200 con un objeto de error	Resultado de no disponibilidad de dispositivo en el endpoint de chat actual.	Inspecciona error.code y no lo muestres como una respuesta del asistente.
400	Solicitud inválida o concesión de OAuth.	Corrige el cuerpo, los parámetros, el callback o el código expirado/consumido.
401	Falta, expiración o autenticación no válida.	Verifica la credencial; actualiza solo un permiso OAuth válido.
402	Créditos insuficientes o saldo aplicable.	Verifica el saldo de la cuenta seleccionada antes de reintentar.
403	Denegación de alcance, propiedad, rol o estado habilitado.	Verifica el límite de permisos documentado.
404	Recurso desconocido o ruta de gateway no compatible.	Verifica el host, la ruta y los identificadores de recursos.
409	Conflicto de estado o revisión.	Lee el estado actual y reconsidera el cambio.
429	Límite de solicitud o concurrencia.	Respeta Retry-After y utiliza un retroceso limitado.
500 / 502 / 503	Fallo de disponibilidad del servidor o del upstream.	Mantén los reintentos limitados; preserva los identificadores de diagnóstico.

Reintenta lecturas con un límite#

Para fallos temporales en lecturas, espera con un retraso creciente y jitter, respeta Retry-After cuando esté presente y detente después de un número definido de intentos o un presupuesto de tiempo. Muestra al usuario cuando los datos no están disponibles en lugar de repetir en bucle silenciosamente.

Trata las escrituras con cuidado#

No repitas automáticamente una actualización de precios, creación de modelo o comando de compartición cuando el resultado sea desconocido. Lee primero el estado del recurso o comando. Usa una Idempotency-Key solo en endpoints que documenten soporte, como cambios de acuerdos.

Los tokens de actualización son de un solo uso#

La rotación de actualización necesita un bloqueo por autorización en tu backend. Un reintento ciego de un token de actualización consumido puede revocar el permiso. Consulta actualización segura de tokens.

Qué incluir en una solicitud de soporte#

Incluye el endpoint, el estado HTTP, el código de error, la hora y el identificador de respuesta/tarea cuando estén disponibles. Elimina los encabezados de Authorization, cookies, secretos de cliente, tokens de acceso, tokens de actualización y contenidos privados de prompts.