Аутентификация и ограничения скорости
Токены аутентификации используются для обеспечения доступа к 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 в анонимном режиме, предоставить ссылку в своем продукте на страницу продукта API DeviceIdentifier.
Получение токена
Аутентификация выполняется с использованием токена, предоставленного 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.", }