如何访问API？ 
 

Fastmarkets data的客户通常有自己的能使用和处理数据的服务。因此，基于单个用户凭证的验证方式并不适用。为此，Fastmarkets分配唯一的服务密钥和服务名称，用于生成访问令牌来调用Fastmarkets认证API。返回的访问令牌（以 JSON Web Token 的形式）用于对其他Fastmarkets API（例如Fastmarkets Physical Prices API）的调用，用以验证调用服务是否拥有查看所请求数据的必要权限。

完整的技术文档，可通过我们的 Swagger UI 进行访问，这需要您拥有指定的技术用户权限。您的用户名和密码将通过欢迎邮件发送给您。收到邮件后，您可以点击右上角的“授权”按钮登录。

获得授权后，您可以：

测试每个端点的请求和响应，查找示例值、字段描述和 API 响应模型，查明每个端点的错误信息。

您将收到一封欢迎邮件，其中包含了您作为 API 技术用户的用户名和密码，以便您访问 API Swagger UI 来测试请求和响应。为了访问和验证我们的 API，我们将提供一个自动生成的服务名称和服务密钥。您可以使用服务名称和密钥在 Postman 等应用程序中进行身份验证，并生成访问令牌，然后从您的系统调用我们的Physical Prices API。
 

有多少技术用户可以访问 Swagger UI？

至少需要一名技术用户来管理服务密钥。但是，我们也理解许多客户在实施过程以及 API 的日常维护中，需要多名技术用户或第三方技术用户来测试请求和响应，这可能需要不同地区的多名团队成员提供支持。如有需要，请通过我们的联系页面申请额外的技术用户—— 我们将竭诚为您提供帮助。

如果您的技术用户发生变更或离职，请通知我们。 

 

合同续签时，我的服务名称和服务密钥会更改或中断吗？ 
 

不，续订时服务名称和服务密钥将保持不变。无需修改 API 的任何身份验证。 
 

如何重新生成服务密钥？ 
 

如果您因安全或其他原因需要重新生成服务密钥，请联系我们 - 让我们来帮您。

请注意，在您将新密钥输入系统之前，API 将无法使用。 
 

另一个业务领域需要通过 API 访问Fastmarkets pricing。我们能否使用相同的服务名称和密钥来实现？

出于安全和许可方面的考虑，不同的业务团队或部门之间，服务密钥不应共享。如有需要，请联系您的客户经理或客户成功团队，他们可以根据需要提供单独的服务名称和密钥。

 

你们有测试环境吗？

我们没有专门的Physical Prices API 测试环境。因此，我们建议您在使用服务密钥连接到生产版本的 API 之前，先使用我们的 Swagger UI 测试请求和响应。这需要指定用户权限，所有 API 技术用户均可使用。如果您需要单独的测试服务名称，请联系我们 - 我们将竭诚为您提供帮助。

 

您有任何示例请求吗？ 
 

请参阅以下链接，了解 JSON、C#、Java 和 Python 中的示例请求。 
 

点击此处访问Fastmarkets Physical Prices API 用户指南 JSON 版本。
点击此处访问Fastmarkets Physical Prices API 用户指南 C# 版本。
点击此处访问Fastmarkets Physical Prices API 用户指南 Java 版

点击此处访问Fastmarkets Physical Prices API 用户指南 Python 版本。 
 

查询次数有哪些限制？ 
 

可以通过指定多个symbols和日期范围，利用Physical Prices API 请求大量数据。但是，在单个 API 请求中所能请求的内容是有一定限制的。具体限制如下：

GET/Prices
Max Symbols: 100
Max Dates: 10 (if requesting latest prices there is no date limit)

GET Prices/History
Max Symbols: 100
Max Date Range: 2 years

请注意，Symbols间的的历史时间序列会因发布日期不同而有所差异。要确定时间序列的起始日期，请参考“firstDate”字段，该字段可通过 GET/Instruments 或 GET/Prices 端点获取。
 

我如何才能找到更多技术信息？

我们的技术文档页面提供了Physical Prices API 的详细技术信息，其中包括：
- 端点和参数描述
- 请求和响应示例
- 模型信息，包含对响应对象的详细描述
- 错误代码和消息示例

更多帮助

如果您还有其他问题或需要进一步的帮助，请查看我们⁠支持中心提供的所有帮助内容。

如果您找不到所需信息并希望联系我们的支持团队，那么⁠让我们为您提供帮助吧。