本文へスキップ

エラー

Ad Placement APIは以下のレスポンスコードを返すことができます：

コード説明説明
400悪いリクエスト送信されたデータが正しくフォーマットされていないことを示す。
200OKこれは、リクエストが正しいか、見つからないゾーンがあることを示しています。どのゾーンであるかは、レスポンスでわかります。
500内部エラー内部エラーが発生したが、原因が不明であることを示します。アカウントマネージャーまたはカスタマーサクセスにお問い合わせください。

400エラーメッセージ​

メッセージ説明
不正なJSONボディ構文エラー
サポートされていないリクエストタイプ誤った要求動詞の使用
このフィールドがない強制フィールドがない
このフィールドは想定外だったリクエストに認識できないパラメータが追加されました。
この値はX型でなければならない。特定のパラメータに誤ったフォーマットが使用されている

400エラーの例​

リクエスト

{
    "user": {
        "testing": false
    },
    "zones": [
        {
            "id": "12345"
        }
    ]
}

反応だ：

{
    "errors": [
        {
            "[user][ua]": "This field is missing."
        },
        {
            "[user][testing]": "This field was not expected."
        },
        {
            "[zones][0]": "[id] This value should be of type int."
        }
    ]
}

200エラーメッセージ​

メッセージ説明
ゾーンIDが見つかりませんゾーンIDが見つからない、またはエンドポイントのドメインが要求された広告フォーマットに対応していない
ゾーンまたはサイトが無効ゾーンまたはパブリッシャーはブロックされています。

200 エラーの例​

この例では、複数のゾーンに広告をリクエストし、そのうちのいくつかはエラーを返した。

リクエスト

{
    "user": {
        "ip": "179.127.135.233",
        "ua": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:81.0) Gecko/20100101 Firefox/81.0"
    },
    "zones": [
        {
            "id": 1
        },
        {
            "id": 2
        },
        {
            "id": 3
        }   
    ]
}

反応だ：

{
    "zones": [
        null,
        {
            "idzone": 2,
            "type": "banner",
            "data": {
                "url": "https://main.example.rocks/click.php?data=H4sIAAAAAAAAA0WPO27DQAxEr.LG7YK__bBMk8ZFzrArrZAiQQLYgFzM4UNZRUCCIMjhw_ACI69SHNYIn4_H7_2qb1d5j9z3Pc1nX.9p.fkGQAAXUvGj4n_D1RNLTaw5iSpgVoQbcbCV2CsytZgyNACBCZASPSUTOAIsSQ1qlFsOVWXeNKDDZ1cuS56j5o1Gtz7K1BonhPHVI09nB_GC1_gMtcwcTl4dHd8dIqdT2k6h4eOG5kK1.7Kts.ncyuijs64unlerZf4BvX2zxCABAAA-",
                "impression": "https://syndication.example.rocks/cimp.php?t=imp&api=1&data=H4sIAAAAAAAAAzVPSW4DMQz7Sj8wBrV5ya1FX9CiD7An9qlFD73MQY+PkmlEG5ZMwqQZjI2wMb0QLpovKk6lJeKSSCyxiL99vLqSz6Nf/9L+++MqrFKeRy3aqrlCQK24oUbfCufmqpmpgpyyiyMgCqsWr8WQtHqBf32+P3aonF2Agw3R320pRJyQyBtc4xJHUJxEvRAtiaijzS6Ud5uj2MLo2keekevuMb57rEdonEj4p54QNaL45UbngHvwKPiDjqqnPPKpwstqmHNera9OZe053DCHrdGXGPUbbttiKlIBAAA=",
                "image": "https://static.example.rocks/library/432437/42ec0144a74a1663f2973ad3070234f8e5633855.jpg"
            }
        },
        null
    ],
    "errors": {
        "0": [
            "Zone 1 not found"
        ],
        "2": [
            "Zone 3 not found"
        ]
    }
}

zones.data null​

ごくまれに、広告ゾーンリクエストは正しいレスポンスを返しますが、'data'フィールドがNULLになることがあります。これは、ユーザーのロケールやブラウザなどから、指定されたリクエストを満たす広告が見つからなかったことを意味します。