错误

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

代码	描述	说明
400	错误请求	表示发送的数据格式不正确。
200	成功	这表示请求正确，或者有一些无法找到的广告位。响应会告诉你这些是哪些广告位。
500	内部错误	表示发生了内部错误，但原因未知。请联系您的客户经理或 客户成功 寻求帮助。

400 错误消息

消息	说明
JSON 正文格式错误	语法错误
不支持的请求类型	使用了错误的请求动词
此字段缺失	缺少必填字段
未预期此字段	请求中添加了无法识别的参数
此值应为 X 类型	特定参数使用了错误的格式

400 错误示例

请求：

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

响应：

{
    "errors": [
        {
            "[user][ua]": "此字段缺失。"
        },
        {
            "[user][testing]": "此字段未预期。"
        },
        {
            "[zones][0]": "[id] 此值应为 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": [
            "未找到广告位 1"
        ],
        "2": [
            "未找到广告位 3"
        ]
    }
}

zones.data 为 null

极少数情况下，广告位请求会返回正确响应，但 data 该字段将为 null。这意味着系统未找到任何可满足给定请求的广告，考虑到用户地区、浏览器等因素。