Pinnacle API — это RESTful-сервис для ставок всех типов на все виды спорта.
api.pinnacle.com
Обратите внимание, что для доступа к API Pinnacle вам необходимо обратиться в компанию Pinnacle Solution за одобрением.
API использует базовую аутентификацию доступа HTTP. Всегда используйте HTTPS для доступа к API.
Вам нужно отправить заголовок HTTP-запроса следующим образом:
Authorization: Basic
Пример:
Authorization: Basic U03MyOT23YbzMDc6d3c3O1DQ1
Обратите внимание: для доступа к API Pinnacle у вас должен быть пополненный счет.
API Pinnacle поддерживает только формат JSON. HTTP-заголовок Accept
должен быть установлен:
Accept: application/json
POST HTTP-запрос должен иметь содержимое тела JSON и должен быть установлен HTTP-заголовок Content-Type
:
Content-Type: application/json
API Pinnacle поддерживает HTTP-сжатие. Мы настоятельно рекомендуем использовать сжатие, поскольку оно обеспечит наилучшую производительность.
Обязательно установите HTTP-заголовок User-Agent
, иначе сжатие может не работать.
Все даты и время указаны в часовом поясе GMT, формате ISO 8601.
Когда клиент отправляет сетевой запрос, всегда возможно, что запрос истечет по тайм-ауту или вернет код ошибки, указывающий, что ставка, возможно, не была принята. Это открывает возможность отправки одного и того же запроса более одного раза, что может привести к созданию дублирующих ставок. Дедупликация — это метод, позволяющий избежать создания дубликатов при повторной попытке запроса на создание. Мы делаем дедупликацию автоматически для вас.
Если ставка принята, мы сохраняем uniqueRequestId
в системе на 30 минут. Если вы попытаетесь еще раз в течение этого периода времени сделать ставку с тем же uniqueRequestId
, вы получите соответствующую ошибку.
Все запросы на размещение ставок поддерживают дедупликацию.
v1 – текущий
v2 — Текущая версия
версия 3 – устарела
v4 – Текущая версия
Чтобы обеспечить соблюдение Политики добросовестного использования и обеспечить стабильное обслуживание всех клиентов, у нас установлены ограничения на скорость API, клиенты могут совершать несколько вызовов API в течение определенного периода времени.
Если предел превышен, клиент может получить ответ об ошибке с кодом состояния HTTP 429
с HTTP-заголовком Retry-After
, который указывает, через сколько секунд клиент может повторить попытку.
Пример:
HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Content-Length: 240
Retry-After: 60
{
"code": "TOO_MANY_REQUESTS",
"message": "Too many snapshot requests. For more details see https://github.com/pinnacleapi/pinnacleapi-documentation#rate-limits
}
Вызовы моментальных снимков Lines API
ограничены: до 1 вызова в минуту для каждого вида спорта на конечную точку. Следующие конечные точки поддерживают снимки:
Примеры моментальных вызовов, которые учитываются одним и тем же счетчиком скорости вызовов спортивной конечной точки:
Используйте пакет pinnacle.API, доступный на CRAN. (install.packages("pinnacle.API")) Исходный код можно найти здесь.
Начиная
Журнал изменений API
Часто задаваемые вопросы
Политика добросовестного использования
Вы можете следить за страницей статуса Pinnacle и подписаться на получение уведомлений о статусе API. Уведомления будут отправляться с адреса [email protected]. Обязательно проверяйте свой почтовый ящик для нежелательной почты.
Мы используем Cloudflare в качестве поставщика доставки контента для API, вы можете следить за их статусом здесь.
Компания Pinnacle не несет ответственности за использование API в каких-либо целях. API предоставляется на условиях «как есть» и «как доступно», без каких-либо гарантий, явных или подразумеваемых, включая, помимо прочего, подразумеваемые гарантии коммерческой ценности и пригодности для конкретной цели или ненарушения прав.