数据更新相关

FAQ

1. 数据可以试用吗？

可以。请先遵照控制台注册指示，绑定商务后，和他联系。商务会给您开放免费体验。

2. 为什么有时候请求会报错"Time out"？

为避免异常请求或者攻击影响整体服务，我们对接口的请求进行了限制。我们默认限制了一分钟内最多请求800次，如有更高的频次要求，请联系商务。详细规则见【API指南 - HTTP 注意事项】。

3. 接口可以直接应用到前端页面吗？

不可以。为了保障您的数据安全，请不要将接口直接应用于前端页面，否则容易泄露自身密钥。请先将数据拉取至自己的服务器，然后再应用于前端。

4. 首次数据接入应该如何做？

列表接口调用：
首次获取，根据入参id循环获取全量数据（第一次调用入参id默认为空，后续入参id为前一次返回数据的最大id+1）。
判断total=0或results为空，全量数据获取结束（记录全量数据中的最大更新时间updated_at）。
全量数据获取结束，后续进行增量更新。
增量更新，根据入参time循环获取变动数据（第一次调用入参time为步骤2中记录的最大更新时间updated_at+1，同上，后续入参time为前一次返回数据的最大更新时间updated_at+1）。
total=0或results为空，增量更新结束（记录最大更新时间updated_at）。
保持增量更新即可（每1分钟/次）。

5. 增量更新time入参查询时，返回数据总数total大于limit的限制，该如何设置？

使用time查询，因为存在同一更新时间有多条数据，而同一更新时间的数据是同步返回的，所以接口返回数量是limit限制数的前后范围内；limit主要用于id查询，因为id是唯一的，所以最大返回数就是limit；time查询，limit默认即可，不需要额外使用。

6. IP 白名单和接口授权后，为什么请求接口还是提示 IP 受限或者接口未授权？

IP 白名单和接口权限我们设置了时效机制，客户配置 IP 地址或者商务授予接口权限后一分钟生效。

7. 我们需要越南语和印尼语的数据，能支持吗？

支持。我们的数据应用了多语言输出，可自由选择中、英等主流语言，并输出对应的语言内容。助力您的全球化数据要求。

8. 使用线上文档测试时，Headers内的参数：app_id以及app_secret重复填写有些麻烦？

不需要多次填写，文件将 Headers 参数：app_id，app_secret 设置为变量，只需要第一次调用时填写即可；需要注意的是清除网页缓存后需要再次填写。

9. 请求的时候没有达到每分钟最大请求次数，为什么还是会报错"Time out"？

我们的每个接口也有自己的请求频次。为了数据请求的稳定性，我们为每个接口设置了最大的请求次数。详见【常见问题 - 接口最大限制频率】。

10. 企业用户能否定制方案？

可以。我们提供定制化企业套餐，支持根据数据量、请求要求、时效性等维度量身定制方案。欢迎通过官网联系商务团队详谈。

如果需要进一步细化行业场景案例或技术接入文件，请联系商务协助补充。

数据更新相关

1. 数据可以试用吗？#

2. 为什么有时候请求会报错"Time out"？#

3. 接口可以直接应用到前端页面吗？#

4. 首次数据接入应该如何做？#

5. 增量更新time入参查询时，返回数据总数total大于limit的限制，该如何设置？#

6. IP 白名单和接口授权后，为什么请求接口还是提示 IP 受限或者接口未授权？#

7. 我们需要越南语和印尼语的数据，能支持吗？#

8. 使用线上文档测试时，Headers内的参数：app_id以及app_secret重复填写有些麻烦？#

9. 请求的时候没有达到每分钟最大请求次数，为什么还是会报错"Time out"？#

10. 企业用户能否定制方案？#