Pinnacle API — это RESTful-сервис для ставок всех типов на все виды спорта.
api.pinnacle.com
Обратите внимание, что для доступа к API Pinnacle вам необходимо обратиться в компанию Pinnacle Solution за одобрением.
API использует базовую аутентификацию доступа HTTP. Всегда используйте HTTPS для доступа к API.
Вам нужно отправить заголовок HTTP-запроса следующим образом:
Authorization: Basic <Base64 value of UTF-8 encoded “username:password”>
Пример:
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 предоставляется на условиях «как есть» и «как доступно», без каких-либо гарантий, явных или подразумеваемых, включая, помимо прочего, подразумеваемые гарантии коммерческой ценности и пригодности для конкретной цели или ненарушения прав.
