Контракт запроса

PATCH /api/v1/portfolios/{portfolioId}/sync. Запросите новое чтение провайдера и обновите сохранённое нормализованное состояние баланса. Передавайте персональный токен в X-API-Key и не размещайте его в браузерном коде или публичных логах.

Ответ и тарификация

Успешный ответ возвращает подключение после синхронизации и заголовки стоимости и остатка кредитов. Успешные платные ответы возвращают X-Credit-Cost и X-Credits-Remaining, чтобы usage можно было записать без дополнительного запроса.

Поведение в production

Не запускайте endpoint в частом polling loop. Лимиты провайдера и стоимость десять кредитов требуют явного расписания. Обрабатывайте application/problem+json по стабильному code, сохраняйте correlation ID и не повторяйте mutation без идемпотентного сценария.