错误

广告投放 API 可以返回以下响应代码：

代码	说明	说明
400	糟糕的请求	表示发送的数据格式不正确。
200	好的	这表明要么请求是正确的，要么有些区无法找到。响应将告诉您是哪些区。
500	内部错误	表示发生了内部错误，但原因不明。请联系您的客户经理或 Customer Success 寻求帮助。

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

在极少数情况下，广告区请求会返回正确的响应，但 "数据 "字段为空。这意味着系统在用户的地域、浏览器等条件下没有找到能满足给定请求的广告。