pinnacleapi文件下載 - pinnacleapi文檔源碼下載

pinnacleapi documentation

其他源碼

下載

概述

Pinnacle API 是一項 RESTful 服務，用於對所有運動項目進行所有投注類型的投注。

 api.pinnacle.com

請注意，要存取 Pinnacle API，您必須聯絡 Pinnacle Solution 以獲得批准。

驗證

API 使用 HTTP Basic 存取身份驗證。始終使用 HTTPS 存取 API。

您需要像這樣傳送 HTTP 請求標頭：

 Authorization: Basic

例子：

 Authorization: Basic U03MyOT23YbzMDc6d3c3O1DQ1

請注意，要存取 Pinnacle API，您必須擁有資金帳戶。

資料格式

Pinnacle API 僅支援 JSON 格式。必須設定 HTTP 標頭Accept ：

    Accept: application/json

POST HTTP 請求必須具有 JSON 正文內容，且必須設定Content-Type HTTP 標頭：

    Content-Type: application/json

壓縮

Pinnacle API 支援 HTTP 壓縮。我們強烈建議使用壓縮，因為它會提供最佳性能。

請確保設定User-Agent HTTP 標頭，否則壓縮可能無法運作。

日期時間格式

所有日期和時間均採用 GMT 時區，ISO 8601 格式

重複資料刪除

當客戶端發出網路請求時，請求總是有可能逾時或傳回錯誤狀態代碼，表示投注可能尚未被接受。這導致同一請求被多次發送的可能性，這可能會產生重複的投注。重複資料刪除是一種避免在重試建立請求時建立這些重複項的技術。我們自動為您進行重複資料刪除。

如果投注被接受，我們會將uniqueRequestId儲存在系統中 30 分鐘。如果您在該時間範圍內再次嘗試使用相同的uniqueRequestId下注，您將收到相應的錯誤。

所有投注請求都支援重複資料刪除。

API參考

客戶API

v1 - 目前

線路API

v2 - 目前

投注API

v3 - 已棄用

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 次呼叫。以下端點支援快照：