Pinnacle API é um serviço RESTful para apostar em todos os tipos de apostas em todos os esportes.
api.pinnacle.com
Observe que para acessar a Pinnacle API você deve entrar em contato com a Pinnacle Solution para aprovação.
A API usa autenticação de acesso HTTP Basic. Sempre use HTTPS para acessar a API.
Você precisa enviar o cabeçalho da solicitação HTTP assim:
Authorization: Basic
Exemplo:
Authorization: Basic U03MyOT23YbzMDc6d3c3O1DQ1
Observe que para acessar a API Pinnacle, você deve ter uma conta com fundos.
A API Pinnacle suporta apenas o formato JSON. O cabeçalho HTTP Accept
deve ser definido:
Accept: application/json
A solicitação POST HTTP deve ter conteúdo do corpo JSON e o cabeçalho Content-Type
HTTP deve ser definido:
Content-Type: application/json
A API Pinnacle oferece suporte à compactação HTTP. Recomendamos fortemente o uso de compactação, pois proporcionaria o melhor desempenho.
Certifique-se de definir o cabeçalho HTTP User-Agent
ou a compactação pode não funcionar.
Todas as datas e horários estão no fuso horário GMT, formato ISO 8601
Quando um cliente emite uma solicitação de rede, é sempre possível que a solicitação expire ou retorne um código de status de erro indicando que a aposta pode não ter sido aceita. Isto abre a possibilidade de o mesmo pedido ser enviado mais de uma vez, o que pode criar apostas duplicadas. A desduplicação é uma técnica para evitar a criação dessas duplicatas ao tentar novamente uma solicitação de criação. Fazemos a desduplicação automaticamente para você.
Se a aposta for aceita, armazenamos o uniqueRequestId
no sistema por 30 min. Se você tentar novamente dentro desse intervalo de tempo fazer uma aposta com o mesmo uniqueRequestId
, receberá o erro apropriado.
Todas as solicitações de apostas suportam desduplicação.
v1 - Atual
v2 - Atual
v3 - Obsoleto
v4 - Atual
Para fazer cumprir a Política de Uso Justo e garantir um serviço estável a todos os clientes, temos limites de taxa de API em vigor, uma série de chamadas de API que os clientes podem fazer dentro de um determinado período de tempo.
Se o limite for excedido, o cliente poderá obter o código de status HTTP de resposta de erro 429
, com o cabeçalho HTTP Retry-After
que especifica após quantos segundos o cliente pode tentar novamente.
Exemplo:
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
}
As chamadas de snapshot Lines API
são limitadas, até 1 chamada por minuto, por esporte e por endpoint. Os seguintes endpoints suportam snapshots:
Exemplos de chamadas instantâneas que são contadas no mesmo contador de taxa de chamada do endpoint esportivo:
Use o pacote pinnacle.API disponível no CRAN. (install.packages(“pinnacle.API”)) O código fonte pode ser encontrado aqui.
Começando
Registro de alterações da API
Perguntas frequentes
Política de uso justo
Você pode seguir a página de status do pinnacle e se inscrever para receber notificações sobre o status da API. As notificações serão enviadas de [email protected], verifique sua caixa de entrada de lixo eletrônico.
Estamos usando Cloudflare como provedor de entrega de conteúdo para a API, você pode acompanhar o status deles aqui.
A Pinnacle não é responsável pelo uso da API para qualquer finalidade. A API é fornecida “como está” e “conforme disponível”, sem garantias de qualquer tipo, expressas ou implícitas, incluindo, sem limitação, garantias implícitas de comercialização e adequação a uma finalidade específica ou de não violação.