Contrato de la solicitud

GET /api/v1/portfolios/{portfolioId}/sync-status. Consulta el estado de la sincronización más reciente sin repetir una llamada al proveedor. Envía el token personal mediante X-API-Key y mantenlo fuera del código del navegador y de los registros públicos.

Respuesta y consumo

La respuesta separa la actualización de saldos del historial de transacciones e incluye el inicio disponible, el punto importado garantizado, la próxima ejecución, los reintentos y una clasificación segura del error. Las respuestas correctas con consumo publican X-Credit-Cost y X-Credits-Remaining para registrar el uso sin realizar otra solicitud.

Comportamiento en producción

Utiliza un sondeo limitado con backoff y detenlo al alcanzar un estado final correcto o fallido. Gestiona los errores application/problem+json mediante su código estable, conserva el identificador de correlación y no repitas una mutación salvo que el flujo sea idempotente.