广告获取接口说明

权限认证

API 通过授权令牌（TOKEN），TOKEN需要在每次请求时通过请求头传入，由运营接口人提供，注册后方能正常使用。

编码方式

若无特殊说明或响应头中的Content-Type未指定编码，请求和响应中的字节编码均使用UTF-8（无BOM 头）。

URI定义

实际对接时请于客服联系。

API请求

HTTP Method

调用方应设置HTTP Method为POST。

HTTP Header

调用方应遵循HTTP协议设置相应的Header，目前支持的Header有：authorization-key、Content-Type;
authorization-key用于传递授权令牌（TOKEN），Content-Type用于指定数据格式;
本章节中Content-Type应为application/json。

HTTP Header示例：

Content-Type: application/json 
authorization-key: Bearer TOKEN

请求JSON 格式

RequestData 对象格式

JSON数据示例

{
    "data": [{
        "adspaceId": "340-20191009110722805",
        "appName": "XXX",
        "district": "150901",
        "city": "150900",
        "province": "150000",
        "densityDpi": 440,
        "deviceId": "LINDAO_399031",
        "networkType": 1,
        "os": 1,
        "screenHeight": 1080,
        "screenWidth": 2248,
        "simOperatorName": 3,
        "premiseId": "123322306061233230606",
        "tradeArea": "1232130203",
        "industries": ["H01701"]
    }]
}

API响应

HTTP状态码:支持HTTP标准状态码

• 其中，4xx 和5xx 的状态码仅用于辅助调用方快速识别问题，不作为包含实际语义的错误码，若有调整也不另行通知，实际操作结果以API返回的数据为准。调用方也应能够识别和处理由于网络异常等因素导致的，由非API 服务返回的HTTP 状态码，如504 Gateway Timeout。

HTTP Header

响应会根据接口要求设置Content-Type。本章节中Content-Type均设置为application/json。

HTTP Body

响应的JSON数据中包含三部分内容，分别为返回码、返回信息和数据，如下表所示：

ResponseData 格式

返回示例

{code:1,
    message:"成功" 
    beginTime："2019-12-03 00:00:00"
    endTime："2020-01-31 00:00:00"
    data:[{    
        "action":1,
        "landpage":" https://itunes.apple.com/cn/app/idXXXXXXXXXX",         
        "showUrl":"https://test.showXXXXX.com",
        "clickUrl":"https://test.clickXXXXX.com ",
        "thridShowUrl":"https://test.tdclickXXXXX.com ",
        "creative_view":1,
        "creative_spec":2,
        "multimedia1_file_url":"http://tt.XXXXX.com/data/640-360.jpg",
        "title":"",
        "description":"" 
    }]
}