Запросы API и квота

Ваш тарифный план включает ежемесячный лимит запросов. На этой странице подробно описано, что считается запросом, какие эндпоинты бесплатны и что происходит при достижении лимита.

Что такое 1 запрос?

1 запрос = 1 обращение к тарифицируемому эндпоинту API, независимо от ответа.

Каждое успешное обращение к тарифицируемому эндпоинту считается ровно за один запрос из вашей квоты. Размер ответа, количество возвращаемых элементов, параметры запроса или HTTP-статус никак не влияют на подсчёт — вызов, возвращающий 1000 фикстур, и вызов, возвращающий 0 фикстур, одинаково расходуют ровно 1 запрос.

Запросы учитываются в рамках подписки, поэтому все вызовы, сделанные с вашим API-ключом, суммируются в одной общей квоте.

Какие эндпоинты учитываются?

Тарифицируемые эндпоинты (учитываются в квоте)

Каждое обращение к этим эндпоинтам использует 1 запрос:

/v4/players
/v4/settlements
/v4/fixtures
/v4/fixture
/v4/odds-by-tournaments
/v4/languages
/v4/sports
/v4/bookmakers
/v4/markets
/v4/tournaments
/v4/participants
/v4/scores
/v4/odds

Бесплатные эндпоинты (НЕ учитываются в квоте)

/v4/historical-odds — всегда бесплатен. Вызовы никогда не увеличивают счётчик запросов.

Неизмеряемые эндпоинты (НЕ учитываются и никогда не блокируются)

/v4/account — всегда доступен, даже после исчерпания квоты. Это гарантирует, что вы всегда сможете проверить статус подписки и остаток квоты.

Когда запрос учитывается?

Запрос учитывается после того, как эндпоинт завершил обработку, независимо от того, был ли ответ успешным или вернулась ошибка. В это входят:

200 OK — успешные ответы
4xx — клиентские ошибки (например, неверные параметры, ресурс не найден)
5xx — серверные ошибки

Примечание

Запросы, отклонённые до достижения эндпоинта — например, из-за неверного API-ключа или исчерпанной квоты — не учитываются.

Достижение лимита

Когда суммарное число запросов достигает значения request_limit вашего плана, любой последующий вызов тарифицируемого или бесплатного эндпоинта (кроме /v4/account) немедленно вернёт:

HTTP/1.1 429 Too Many Requests

{
  "message": "Request limit exceeded",
  "details": "You have exceeded your request limit of X requests.",
  "code": "REQUEST_LIMIT_EXCEEDED"
}

Вы можете продолжать вызывать /v4/account в любое время, чтобы проверить подписку, текущее использование и срок сброса квоты.

Проверка использования

Вызовите GET /v4/account в любое время. Ответ содержит для активной подписки:

request_limit — лимит вашего плана
request_count — сколько тарифицируемых запросов вы израсходовали за текущий период

Советы по снижению расхода запросов

Кэшируйте ответы на стороне клиента, когда базовые данные меняются редко (например, /v4/sports, /v4/bookmakers, /v4/markets, /v4/languages).
Объединяйте, где возможно — используйте /v4/fixtures с фильтрами вместо множества одиночных вызовов, когда нужно получить сразу несколько фикстур.
Опрашивайте разумно — каждый опрос тарифицируемого эндпоинта — это 1 запрос, поэтому согласуйте интервал опроса с частотой реальных изменений данных.

Предыдущая страницаOverview

Следующая страницаGET account