Contrato de la solicitud

PATCH /api/v1/portfolios/{portfolioId}/sync. Solicita una nueva lectura al proveedor y actualiza el estado normalizado de los saldos almacenados. 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

Tras añadir la tarea a la cola persistente, una respuesta correcta indica SYNCING y publica los encabezados de coste y créditos restantes. Consulta el endpoint de estado hasta que termine. 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

No llames a este endpoint en un bucle de sondeo rápido. Los límites de frecuencia del proveedor y el coste de diez créditos hacen importante una planificación explícita. 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.