ym88659208ym87991671
Получение статистики по количеству запросов к API - интеграция для партнеров | Документация для разработчиков

Получение статистики по количеству запросов к API

Обновлено 29 февраля 2024

Для обращения к ресурсу необходимо отправлять запрос на:

  • Тестовый контур https://iftfintech.testsbi.sberbank.ru:9443

  • Промышленный контур https://fintech.sberbank.ru:9443

Получение статистики

Ресурс /v1/partner-info/request-statistics позволяет Партнеру получить статистику по количеству запросов к API.

Шаги

1. Получить AccessToken.

2. Отправить запрос.

Для получения статистики необходимо отправить GET-запрос (/v1/partner-info/request-statistics), в котором передать авторизационный токен собственной организации (Access Token). Авторизационный токен передается в параметре Authorization заголовка запроса.

Чтобы получить доступ к ресурсу, необходимо передать в scope сервис GET_REQUEST_STATISTICS.

Модель запроса

НаименованиеОписание
Параметры заголовка
Authorization (String)Access token собственной организации, полученный через SSO. Пример: Bearer c76fb018-27c9-43f7-a751-62646eda7e1a-1
Параметры запроса
dateSince (Date)Дата начала периода (yyyy-MM-dd)
dateUntil (Date)Дата окончания периода (yyyy-MM-dd)
clientId (String)Идентификатор сервиса

Пример запроса

curl -X GET --header 'Accept: application/json' --header
'Authorization: c76fb018-27c9-43f7-a751-62646eda7e1a-1'
'https://iftfintech.testsbi.sberbank.ru:9443/fintech/api/v1/partner-info/request-statistics?
dateSince=2020-01-21&dateUntil=2020-01-25&clientId=0000'

Модель ответа

НаименованиеОписание
RequestStatistics {
billingObjects (Array[BillingObjectStatistics], optional)Статистика тарифицируемых запросов,
nonBillingObjects (Array[BillingObjectStatistics], optional)Статистика нетарифицируемых запросов
}
BillingObjectStatistics {
numberRequests (integer, optional)Количество запросов за период,
serviceName (string, optional)Наименование запроса,
serviceSystemName (string, optional)Системное наименование запроса
}

Пример ответа

{
"billingObjects": [{
"numberRequests": 1000,
"serviceName": "Код авторизации",
"serviceSystemName": "sso-authorize"
}],
"nonBillingObjects": [{
"numberRequests": 1000,
"serviceName": "Код авторизации",
"serviceSystemName": "sso-authorize"
}]
}

Коды возврата

Код возвратаОписание кода возвратаПричина возникновения
200OK
Успешный код возврата
400DESERIALIZATION_FAULT
Неверный формат запросаНеверный формат запроса
401UNAUTHORIZED
accessToken not found by value =хххххххх-хххх-хххх-хххх-хххххххххххх-хУказан некорректный или просроченный access_token.
403ACTION_ACCESS_EXCEPTION
Операция не может быть выполнена: доступ к ресурсу запрещенУ пользователя нет прав на использование соответствующего сервиса Sber API (Fintech API), доступ к которому не предусмотрен настройками scope;
У пользователя отсутствует оферта с внешним сервисом.
500UNKNOWN_EXCEPTION
Внутренняя ошибка сервера
503UNAVAILABLE_RESOURCE_EXCEPTION
Сервис временно недоступенПроводятся технические работы
ПАО Сбербанк использует cookie для персонализации сервисов и удобства пользователей.
Вы можете запретить сохранение cookie в настройках своего браузера.