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 次调用。以下端点支持快照：