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

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

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

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

Поведение в production

Используйте ограниченный polling с backoff и прекращайте его при terminal success или failure. Обрабатывайте application/problem+json по стабильному code, сохраняйте correlation ID и не повторяйте mutation без идемпотентного сценария.