Pinnacle API est un service RESTful permettant de parier tous les types de paris sur tous les sports.
api.pinnacle.com
Veuillez noter que pour accéder à l'API Pinnacle, vous devez contacter Pinnacle Solution pour obtenir l'approbation.
L'API utilise l'authentification d'accès HTTP Basic. Utilisez toujours HTTPS pour accéder à l'API.
Vous devez envoyer l'en-tête de requête HTTP comme ceci :
Authorization: Basic
Exemple:
Authorization: Basic U03MyOT23YbzMDc6d3c3O1DQ1
Veuillez noter que pour accéder à l'API Pinnacle, vous devez disposer d'un compte approvisionné.
L'API Pinnacle prend uniquement en charge le format JSON. L'en-tête HTTP Accept doit être défini :
Accept: application/json
La requête HTTP POST doit avoir un contenu de corps JSON et l'en-tête HTTP Content-Type doit être défini :
Content-Type: application/json
L'API Pinnacle prend en charge la compression HTTP. Nous vous recommandons fortement d'utiliser la compression car elle offrirait les meilleures performances.
Veuillez vous assurer de définir l'en-tête HTTP User-Agent , sinon la compression pourrait ne pas fonctionner.
Toutes les dates et heures sont au fuseau horaire GMT, format ISO 8601
Lorsqu'un client émet une requête réseau, il est toujours possible que la requête expire ou renvoie un code d'état d'erreur indiquant que le pari n'a peut-être pas été accepté. Cela ouvre la possibilité que la même demande soit envoyée plusieurs fois, ce qui pourrait créer des paris en double. La déduplication est une technique permettant d'éviter de créer ces doublons lors d'une nouvelle tentative de demande de création. Nous effectuons la déduplication automatiquement pour vous.
Si le pari est accepté, nous stockons le uniqueRequestId dans le système pendant 30 min. Si vous réessayez pendant cette période pour placer un pari avec le même uniqueRequestId , vous obtiendrez l’erreur appropriée.
Toutes les demandes de pari prennent en charge la déduplication.
v1 - Actuel
v2 - Actuel
v3 - Obsolète
v4 - Actuel
Pour appliquer la politique d'utilisation équitable et garantir un service stable à tous les clients, nous avons mis en place des limites de débit API, un certain nombre d'appels API que les clients peuvent effectuer au cours d'une période donnée.
Si la limite est dépassée, le client peut recevoir la réponse d'erreur HTTP status code 429 , avec l'en-tête HTTP Retry-After qui spécifie après combien de secondes le client peut réessayer.
Exemple:
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
}
Les appels instantanés Lines API sont limités, jusqu’à 1 appel par minute, par sport et par point de terminaison. Les points de terminaison suivants prennent en charge les instantanés :
Exemples d'appels instantanés comptabilisés dans le même compteur de taux d'appels de point de terminaison sportif :
Veuillez utiliser le package pinnacle.API disponible sur CRAN. (install.packages("pinnacle.API")) Le code source peut être trouvé ici.
Commencer
Journal des modifications de l'API
FAQ
Politique d'utilisation équitable
Vous pouvez suivre la page d'état de Pinnacle et vous abonner pour recevoir les notifications sur l'état de l'API. Les notifications seront envoyées depuis [email protected], assurez-vous de vérifier votre boîte de réception indésirable.
Nous utilisons Cloudflare comme fournisseur de diffusion de contenu pour l'API, vous pouvez suivre leur statut ici.
Pinnacle n'est pas responsable de l'utilisation de l'API à quelque fin que ce soit. L'API est fournie « telle quelle » et « telle que disponible », sans garantie d'aucune sorte, expresse ou implicite, y compris, sans s'y limiter, les garanties implicites de qualité marchande et d'adéquation à un usage particulier ou de non-contrefaçon.
