身份验证和速率限制
身份验证令牌用于启用对API的访问,而不受速率限制或数据限制。这采用了像ubxbhwera9xkmx4yoej6yt5tslvpjcdj
这样的格式。每个客户端使用一个或多个令牌连接到API,因为每个令牌都与一组权限相关联。
{ "message": "You have been ratelimited; please sign up for a key at https://reincubate.com/deviceidentifier-api/ if you require a larger limit", "retry_after": 3405, "type": "permission_denied_rate" }
我们要求以匿名模式使用API的用户在其产品中提供返回DeviceIdentifier API 产品页面的链接 。
获取令牌
使用Reincubate提供的令牌执行身份验证,可以在此处获取 。
使用令牌进行身份验证
如果有一个ubxbhwera9xkmx4yoej6yt5tslvpjcdj
的令牌,可以通过将HTTP Authorization
标头设置为Token ubxbhwera9xkmx4yoej6yt5tslvpjcdj
来使用它。像这样:
$ wget https://di-api.reincubate.com/v1/gsma-imeis/352073069165968/ --header="Authorization: Token ubxbhwera9xkmx4yoej6yt5tslvpjcdj" -qSO - --content-on-error
客户端库包含自己的文档,并支持通过环境变量设置的令牌,如下所示:
$ export RI_DEVID_TOKEN='ubxbhwera9xkmx4yoej6yt5tslvpjcdj'
使用积分
可以通过使用积分获得对API的访问。每个唯一查询都会使用一个信用,这意味着重复请求相同的信息将只使用一个信用。
如果您使用的令牌与使用信用相关联,则来自API的响应将包含标头Di-Credits-Remaining
和未使用信用的计数。
如果令牌用完了信用额度,您仍然可以重复以前进行的查询,但是带有新查询的请求将返回HTTP 403响应。
{ "type": "no_credits_remaining", "message": "There are no credits remaining on this token. Please contact enterprise@reincubate.com for additional credits.", }