Contrat de la requête

PATCH /api/v1/portfolios/{portfolioId}/sync. Demandez une nouvelle lecture au fournisseur et mettez à jour l'état normalisé des soldes enregistrés. Envoyez le jeton personnel au moyen de X-API-Key et conservez-le hors du code du navigateur et des journaux publics.

Réponse et consommation

Après la mise en file persistante, une réponse réussie indique SYNCING et publie les en-têtes de coût et de crédits restants. Interrogez l'endpoint d'état jusqu'à la fin. Les réponses facturées réussies publient X-Credit-Cost et X-Credits-Remaining afin d'enregistrer l'utilisation sans requête supplémentaire.

Comportement en production

N'appelez pas cet endpoint dans une boucle d'interrogation serrée. Les limites de débit du fournisseur et le coût de dix crédits exigent une planification explicite. Traitez les erreurs application/problem+json selon leur code stable, conservez l'identifiant de corrélation et ne répétez jamais une mutation sauf si le parcours est idempotent.