API: статистика использования «Дадаты»
Возвращает агрегированную статистику и остатки за сегодняшний день по каждому из сервисов:
- стандартизация (
clean
); - компания по email (
company
), - поиск дублей (
merging
), - подсказки (
suggestions
).
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
curl -X GET \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -H "Authorization: Token ${API_KEY}" \ -H "X-Secret: ${SECRET_KEY}" \ https://dadata.ru/api/v2/stat/daily
// https://github.com/hflabs/dadata-csharp var token = "${API_KEY}"; var secret = "${SECRET_KEY}"; var api = new ProfileClientAsync(token, secret); var result = await api.GetDailyStats();
var url = "https://dadata.ru/api/v2/stat/daily"; var token = "${API_KEY}"; var secret = "${SECRET_KEY}"; var options = { method: "GET", mode: "cors", headers: { "Content-Type": "application/json", "Authorization": "Token " + token, "X-Secret": secret } } fetch(url, options) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log("error", error));
// https://github.com/hflabs/dadata-php $token = "${API_KEY}"; $secret = "${SECRET_KEY}"; $dadata = new \Dadata\DadataClient($token, $secret); $result = $dadata->getDailyStats();
# https://github.com/hflabs/dadata-py from dadata import Dadata token = "${API_KEY}" secret = "${SECRET_KEY}" dadata = Dadata(token, secret) result = dadata.get_daily_stats()
Укажите при вызове:
Content-Type: application/json
.Accept: application/json
.${API_KEY}
— API-ключ.${SECRET_KEY}
— секретный ключ.
Тело запроса передавайте в кодировке UTF-8
.
Ответ:
{ "date": "2023-05-23", "services": { "clean": 500, "company": 50, "merging": 0, "suggestions": 30000 }, "remaining": { "clean": 1000, "company": 30, "merging": 15000, "suggestions": 20000 } }
В поле services
возвращается суммарное количество запросов,
израсходованное по каждому сервису с начала суток.
В поле remaining
возвращается расчетное количество
оставшихся запросов согласно балансу и тарифу.
Например, если баланс составляет 150 ₽, то, согласно тарифам «Дадаты», его достаточно для:
- 15000 записей «Поиска дублей»;
- или 1000 записей «Стандартизации»;
- или 30 запросов «Компаний по емейлу».
То есть количества в remaining.clean
, remaining.company
и remaining.merging
— взаимоисключающие. Именно это и отражает пример выше.
Количество в remaining.suggestions
рассчитывается из тарифного плана и не зависит от баланса.