次の方法で共有

API 認証

  • [アーティクル]

API サービスまたはレポートを呼び出す前に、ユーザー名とパスワードを使用して認証サービスから承認トークンを取得する必要があります。 トークンは 2 時間アクティブのままであり、その間は再認証する必要はありません。 このページでは、認証プロセスについて説明します。

ヒント

ユーザー名またはパスワードを忘れた場合は、 アカウント回復サービス を使用してユーザー名を取得するか、新しいパスワードを作成できます。

手順 1: ユーザー名とパスワードを含む JSON 形式のファイルを作成する

以下では、 コマンドを cat 使用してファイルの出力を表示しました。

$ cat auth
{
    "auth": {
        "username" : "USERNAME",
        "password" : "PASSWORD"
    }
}

手順 2: POST 認証サービスへのファイル

要求は、2 時間有効なトークンを返します。 要求で をPOST使用して"-b cookies -c cookies"、トークンを Cookie に格納することをお勧めします。

$ curl -b cookies -c cookies -X POST -d @auth 'https://api.appnexus.com/auth'
{
    "response": {
        "status": "OK",
        "token": "h20hbtptiv3vlp1rkm3ve1qig0",
        "dbg_info": {
            ...
        }
    }
}

手順 3: API サービスとレポートを呼び出すときにトークンを使用する

次の例では、メンバー サービスを呼び出し、Cookie に格納されているトークンを使用して認証します。

$ curl -b cookies -c cookies 'https://api.appnexus.com/member'
{
    "response": {
        "members": [
            {
                "id": "1",
                "name": "Car company c\/o Ad Agency",
                "active": "1",
                "bidder_id": "2"
            }
        ]
    }
}

または、トークンを Cookie に格納しなかった場合は、要求ヘッダー "Authorization: TOKEN"に としてトークンを配置できます。

$ curl -H "Authorization: 622cee5f8c99c81e87614e9efc63eddb" 'https://api.appnexus.com/member'
{
    "response": {
        "members": [
            {
                "id": "1",
                "name": "Car company c\/o Ad Agency",
                "active": "1",
                "bidder_id": "2"
            }
        ]
    }
}

認証頻度

認証後、トークンは 2 時間有効なままになります。 この時間内に再認証する必要はありません。

注:

再認証を行う場合は、次の制限事項に注意してください。

  1. この API を使用すると、5 分間に 10 回正常に認証できます。
  2. この 5 分以内にそれ以降の認証が試行されると、エラーが発生します。

ヒント

呼び出し応答で "NOAUTH" を error_id リッスンし、受信した後にのみ再認証することをお勧めします。