广告源管理（新版v3）

注意：接入Api前请先熟悉api签名机制（参考接口鉴权说明）, 即Api请求样例中的一些http请求头的来源

1. 获取广告源列表

1.1 请求URL

https://openapi.toponad.com/v3/units/list

1.2 请求方式

GET

1.3 请求参数

1.4 响应参数

1.5 样例

请求样例：

curl --location --request GET 'https://openapi.toponad.com/v3/units/list?app_ids=a63f5cced466da&placement_ids=b1ehgn65hup6v0,b640ae1464e7e9&network_ids=4779,4780&start=0&limit=200 ' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0===b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626056011000' \
--header 'Content-Type: application/json' \
--data-raw ''

返回样例：

{
    "total": 10,
    "items": [
        {
            "app_id": "a6392a1c24510e",
            "placement_id": "b6392a1d36f73f",
            "network_id": 5117,
            "id": 2279787,
            "name": "ADX",
            "nw_firm_id":15
        },
        {
            "app_id": "a6392a1c24510e",
            "placement_id": "b6392a1d59c06f",
            "network_id": 5117,
            "id": 2279797,
            "name": "ADX",
             "nw_firm_id":15
        }
    ]
}

2. 获取广告源详情

2.1 请求URL

https://openapi.toponad.com/v3/units

2.2 请求方式

GET

2.3 请求参数

2.4 响应参数

2.5 样例

请求样例：

curl --location --request GET 'https://openapi.toponad.com/v3/units?ids=417018,374133' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0===b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626056011000' \
--header 'Content-Type: application/json' \
--data-raw ''

返回样例：

[
    {
        "id": 374133,
        "placement_id": "b6049c640e6ad1",
        "network_id": 4779,
        "name": "穿山甲_rv_3",
        "type": 2,
        "mix_format": -1,
        "adsource_token": {
            "app_id": "5343323",
            "personalized_template": "1",
            "slot_id": "4566363563"
        },
        "auto_unit_sw": 2,
         "nw_firm_id":15
    },
    {
        "id": 417018,
        "placement_id": "b6049c640e6ad1",
        "network_id": 4779,
        "name": "穿山甲_rv_6",
        "type": 2,
        "mix_format": -1,
        "adsource_token": {
            "app_id": "5343323",
            "personalized_template": "0",
            "slot_id": "324ewrwe"
        },
        "auto_unit_sw": 2,
         "nw_firm_id":15
    }
]

3. 创建广告源

注意：创建广告源成功后默认是解绑+关闭状态（因为这些属性是流量分组相关的，即在不同流量分组会不一样），需要再次调用聚合管理的广告源管理Api2或Api5来根据需要在指定流量分组绑定和开启

3.1 请求URL

https://openapi.toponad.com/v3/units

3.2 请求方式

POST

3.3 请求参数

3.4 返回参数

3.5 样例

请求样例：

curl --location --request POST 'https://openapi.toponad.com/v3/units' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "placement_id": "b64993cxxxx",
    "items": [
        {
            "network_id": 4778,
            "name": "xcj_admob_openapi1",
            "adsource_token": {
                "unit_id":"123456790000",
                "orientation":"1"
            },
            "mix_format":-1,
            "type": 2
        }
    ] 
}'

返回样例：

{
    "errs": [
        {
            "index": 0,
            "code": 4000,
            "msg": "the unit type is invalid"
        }
    ]
}

4. 修改广告源

4.1 请求URL

https://openapi.toponad.com/v3/units

4.2 请求方式

PUT

4.3 请求参数

4.4 返回参数

4.5 样例

请求样例：

curl --location --request PUT 'https://openapi.toponad.com/v3/units' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "placement_id": "b64993cxxxx",
    "items": [
        {
            "id": 4778,
            "name": "xcj_admob_openapi1",
            "adsource_token": {
                "unit_id":"123456790000",
                "orientation":"1"
            }
        }
    ]
}'

返回样例：

{

}

5. 批量删除广告源

注意：暂时还是v1, 待后续升级v3

5.1 请求URL

https://openapi.toponad.com/v1/del_units

5.2 请求方式

POST

5.3 请求参数

5.4 返回参数

5.5 样例

请求样例：

curl --location --request PUT 'https://openapi.toponad.com/v1/del_units' \
--header 'X-Up-Key: 877f8ae9c6e9ca82c0==5b5fff594c373axxx' \
--header 'X-Up-Signature: CE12B506DBCD868C2C6F09E08C139CBC' \
--header 'X-Up-Timestamp: 1626161553000' \
--header 'Content-Type: application/json' \
--data-raw '{
    "adsource_ids":[19683]
}'

返回样例：

{
    "msg": "suc"
}