認証とレート制限

認証トークンは、レート制限やデータ制限なしにAPIへのアクセスを可能にするために使用されます。これは、 ubxbhwera9xkmx4yoej6yt5tslvpjcdjような形式をubxbhwera9xkmx4yoej6yt5tslvpjcdjます。各クライアントは一連の権限に関連付けられているため、各クライアントは1つ以上のトークンを使用して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へのアクセスは、使用クレジットを介して取得できます。クレジットは一意のクエリごとに使用されます。つまり、同じ情報を繰り返し要求すると、1つのクレジットのみが使用されます。

使用クレジットが関連付けられたトークンを使用している場合、APIからの応答には、ヘッダーDi-Credits-Remainingと未使用のクレジットの数が含まれます。

トークンのクレジットが不足した場合でも、以前に行ったクエリを繰り返すことはできますが、新しいクエリを使用したリクエストはHTTP403応答を返します。

{
    "type": "no_credits_remaining",
    "message": "There are no credits remaining on this token. Please contact enterprise@reincubate.com for additional credits.",
}