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 ₽, то, согласно тарифам «Дадаты», его достаточно для:

• 7500 записей «Поиска дублей»;
• или 750 записей «Стандартизации»;
• или 21 запросов «Компаний по емейлу».

То есть количества в  remaining.clean,remaining.companyи remaining.merging — взаимоисключающие. Именно это и отражает пример выше.

Количество в  remaining.suggestions рассчитывается из тарифного плана и не зависит от баланса.