{
  "dspid":"11268", // DSP ID
  "token":"92205dff8f9d48e1b7a26b0b88af7dc1", // DSP Token
  ... // 其他业务参数，将在下面各节API详细介绍中说明
}

\\ POST 'http://{youku.adx.domain}/dsp/api/adplacements'
\\ JSON:
{"dspid":"11268","token":"92205dff8f9d48e1b7a26b0b88af7dc1"}

{
    "result":0,
    "message":
    {
        "total" :2, // 总数
        "count" :2,  // 本次返回数，这个字段是预设的未来可以分页读取的参数，现在都和total相等
        "records" : [{  // 广告位数组
            "adplacementid": 101,  // 广告位ID, integer类型
            "adplacementname": "汽车-首页-banner" ,  // 名称
            "size": "300*250" ,  // 尺寸，"width*height"
            "bidfloor": 20 ,     // 广告位底价，单位是：分/CPM
            "blockcategory": ["1", "2"] , // 广告主行业黑名单，这里的值是黑名单行业的行业ID，具体行业映射表见字典文件<http://api.yes.youku.com/dicts/industry.txt>
            "allowmaterial": ["jpg", "gif", "swf", "png"]  // 允许的素材类型，内容是后缀名。注意，“优酷”视频贴片素材在这里是用flv代表的
            "bidfloor": 300,                    //广告位低价，单位：分/CPM
            "native_template_ids": []    //信息流广告位模板ID
            "openType": "banner"    //广告类型（banner/video/native）
        },{
            "adplacementid": 101,  // 广告位ID, integer类型
            "adplacementname": "汽车-首页-banner" ,  // 名称
            "size": "0*0" ,  // 尺寸，"width*height"
            "bidfloor": 20 ,     // 广告位底价，单位是：分/CPM
            "blockcategory": ["1", "2"] , // 广告主行业黑名单，这里的值是黑名单行业的行业ID，具体行业映射表见字典文件<http://api.yes.youku.com/dicts/industry.txt>
            "allowmaterial": []  // 允许的素材类型，内容是后缀名。注意，“阿里妈妈全域媒体”视频贴片素材在这里是用flv代表的
            "bidfloor": 300,                    //广告位低价，单位：分/CPM
            "native_template_ids": ["1001", "1002"]    //信息流广告位模板ID
            "openType": "native"    //广告类型（banner/video/native）
        },{
        }]
    }
}

\\ POST 'http://{youku.adx.domain}/dsp/api/uploadadvertiser'
\\ JSON:
{
    "dspid":"11268",
        "token":"92205dff8f9d48e1b7a26b0b88af7dc1",
        "advertiser":{
            "name":"合一网络技术有限公司",
            "brand":"优酷”“土豆",
            "address":"北京市海淀区中关村大街8号中国大厦22层",
            "contacts":"张三",
            "tel":"18699998888",
            "firstindustry":3,
             "secondindustry":5,
             "qualifications":[{
                 "name": "营业执照",    // 必须填写
                 "url": "http://material.client.com/123.jpg", // 资质文件的URL地址
                 "md5": "38b8c2c1093dd0fec383a9d9ac940515",
                 "operation": "add"
             },{
                 "name": "网络文化经营许可证",    // 必须填写
                 "url": "http://material.client.com/456.jpg", // 资质文件的URL地址
                 "md5": "38b8c2c1093dd0fec383a9d9ac940sdf",
                 "operation": "add"
             }]
        }
}

{
    "result":0, //成功
    "message": {}
}

{
    "result":1, //DSP认证失败
    "message":"认证失败"
}

{
    "result":2, //请求参数错误
    "message":"json格式错误",
}

{
    "result":3, //其他错误
    "message"{"119":["营业执照 is exist","网络文化经营许可证 is exist"]},
}

{
    "dspid":"11268",
    "token":"92205dff8f9d48e1b7a26b0b88af7dc1",
    "advertiser":"合一网络"
}

{
    "result":0
        "message":{
            "name": "合一网络技术有限公司",
                "brand": "“阿里妈妈全域媒体”土豆",
                "address":"北京市海淀区中关村大街8号中国大厦22层",
                "contacts":"张三",
                "tel":"18699998888",
                "firstindustry":3,
                "secondindustry":5,
                "state":"通过",
                "refusereason":"广告主非法", //在state为拒绝的情况下才会传递拒绝原因
                "industryid":12, //如果该广告主针对某一行业有些才会传递该字段(由运营手动审核后标记广告主投放的行业)
                "qualifications"[{
                    "name":"广告主资质名称",
                    "md5":"38b8c2c1093dd0fec383a9d9ac940515",
                    "url":"http://r1.ykimg.com/material/0A05/qualification/2077/4aa90305b8dc24c86e3b40a983664f1e.jpg" //通过DSP提供的URL拉取到CDN的访问地址
                },{
                    "name":"广告主资质名称",
                    "md5":"38b8c2c1093dd0fec383a9d9ac940515",
                    "url":"http://r1.ykimg.com/material/0A05/qualification/2077/4aa90305b8dc24c86e3b40a983664f1e.jpg" //通过DSP提供的URL拉取到CDN的访问地址
                }]
        }
}

\\ POST 'http://{youku.adx.domain}/dsp/api/upload'
\\ JSON:
{
    "dspid":"11268",
    "token":"92205dff8f9d48e1b7a26b0b88af7dc1",
    "material":
    [
    // RTB material素材提交
    {
        "crid":"dsp_crid_11101",
        "url": "https://v.youku.com/v_show/id_XMzc1NDUxNjUwMA==.html", // 素材的URL地址
        "landingpage": "http://www.some.com", // 点击跳转落地页的地址
        "advertiser": "广告主的名称",    // 必须填写
        "startdate":"2012-07-16",    //素材生效时间，格式要求：YYYY-mm-dd，必须填写
        "enddate":"2012-08-30",     //素材失效时间，格式要求：YYYY-mm-dd，必须填写
        "monitor": [], // 曝光监测地址：非必填
    },
    // PDB 素材提交
    {
        "crid":"dsp_crid_11102",
        "creative": [ {
        	"attr_name":"video",
        	"attr_value": "https://v.youku.com/v_show/id_XMzc1NDUxNjUwMA==.html",
        	"md5": "a5d69636cbf7c899647d4484df04bb78",
        	"ext": "mp4"
        	},{
        	"attr_name":"image",
        	"attr_value": "http://creative.jdkic.com/img/6e4e281843f3
4d3a84533374112b6e0c.jpg",
        	"md5": "70098db4b6ad6036e85d20e9d715e2a7",
        	"ext": "jpg"
        	},{
        	"attr_name":"logo_title",
        	"attr_value": "三国2"
        	},
        ],
        "landingpage": "http://www.some.com",
        "advertiser": "广告主的名称",
        "startdate":"2012-07-16",
        "enddate":"2012-08-30",
        "monitor": ["http://miaozhen.com/1", "http://miaozhen.com/2"]
    }],
    // RTB native素材提交
    "native":[{
        "native_template_ids":["100"],
        "crid":"dsp_crid_11001",
        "title":"美丽中国",
        "image_url":"http://cdn.youku.com/beautifulchina.jpg",
        "advertiser":"广告主名称",
        "startdate":"2012-08-16",
        "enddate":"2013-08-16",
        "landingpage":"http://yes.youku.com",
        "monitor": ["http://miaozhen.com/1", "http://miaozhen.com/2"]
    }]
}

{
    "result":0,
    "message": {} // message对象为空，所有素材均成功上传
}

{
    "result":3,
    "message":
    {
        "102":["http://material.client.com/123.abc"], // Error 102: 不支持的素材格式
        "103":["http://material.client.com/134.jpg"]  // Error 103: 无法获取素材的尺寸信息
        "103":["dsp_crid_11001"]  // Error 103: 无法获取素材的尺寸信息
    }
}

\\ POST 'http://{youku.adx.domain}/dsp/api/status'
\\ JSON:
{
    "dspid":"11268",
    "token":"92205dff8f9d48e1b7a26b0b88af7dc1",
    "materialurl":["http://material.client.com/134.swf","http://material.client.com/135.swf","http://material.client.com/136.swf"]
    "crid":["dsp_crid_11001","dsp_crid_11002","dsp_crid_11003"]
}

{
    "result":0,
    "message":
    {
        "total" :3,
        "records" : [
        {
            "crid": "dsp_crid_11001",
            "url": "http://material.client.com/134.swf",
            "result":"不通过"
            "reason": "默认素材不需要上传了"
        },{
            "crid": "dsp_crid_11002",
            "url": "http://material.client.com/135.swf",
            "result":"通过"
            "reason": ""
        },{
            "crid": "",
            "url": "http://material.client.com/136.swf",
            "result":"待审核"
            "reason": ""
        }]
    }
}

\\ POST 'http://{youku.adx.domain}/dsp/api/reject'
\\ JSON:
{
    "dspid":"11268",
    "token":"92205dff8f9d48e1b7a26b0b88af7dc1",
    "uploaddate":"2013-12-24"
}

{
    "result":0,
    "message":
    {
        "total" :2,
        "records" : [
        {
            "crid": "dsp_crid_11001",
            "url": "http://material.client.com/123.swf",
            "reason": "显示异常"
        },
        {
            "crid": "",
            "url": "http://material.client.com/134.swf",
            "reason": "跳转地址异常"
        }
        ]
    }
}

\\ POST 'http://{youku.adx.domain}/dsp/api/report'
\\ JSON:
{
    "dspid":"11268",
    "token":"92205dff8f9d48e1b7a26b0b88af7dc1",
    "type":"general"/"detail",
    "startdate":"2012-12-01",
    "enddate":"2012-12-07"
}

{
    "result":0,
    "message":
    [{
        "bid": 5000,
        "winbid": 4000,
        "pv": 3950,
        "click": 125,
        "cost": 120.00,
        "platformincome":20.00
    }]
}

{
    "result":0,
        "message":
        {
            "total" :1,
            "records" :
            {
                "2012-02-01":
                    [{
                        "aid": "101", // 2012年2月1日再广告位ID=101上的统计数据
                        "bid": 6400,
                        "winbid": 4300,
                        "pv": 4100,
                        "click": 200,
                        "cost": 980.00,
                        "platformincome":10.00
                    },{
                        "aid": "102",
                        "bid": 3600,
                        "winbid": 2000,
                        "pv": 1990,
                        "click": 40,
                        "cost": 90.00,
                        "platformincome":9.00
                    }]
            }
        }
}

\\ POST 'http://{youku.adx.domain}/dsp/api/industry'
\\ JSON:
{"dspid":"11268","token":"92205dff8f9d48e1b7a26b0b88af7dc1"}

{
    "result":0,
    "message":
    {
        "total" :2, // 总数
        "records" : [ // 广告主-行业对应关系数组
        {
            "advertiser": "汽车-首页-banner" ,  // 名称
            "industry": "1", // 广告主行业id
        },
        {
            "advertiser": "新闻-视频",
            "industry": ""
        }
        ]
    }
}

{
    "id":"auction-server-1.2-sandbox-1-t12-1387962585-0-702",//请求id
    "site":{//媒体站点对象
        "name":"联调网站1",
        "ref":"",
        "page":"http://www.youku.com/"//当前页面url
    },
    "device":{//设备对象
        "ip":"192.168.1.226",
        "ua":"Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:20.0) Gecko/20100101 Firefox/20.0"
    },
    "user":{//用户对象
        "id":"1393314446719HTx"//
        "tag":{
            "1": 50,
            "2": 50
        }
    },
    "imp":[{//曝光对象
        "id":"00448754623f45c7a245274392213a0f",//曝光id
        "tagid":"319",//曝光对应的exchange系统的广告位id
        "bidfloor":1,//广告位低价
        "banner":{
            "w":300, //广告位尺寸
            "h":250,
            "pos":"3",//第几屏
        }
    }]
}

{
   "id" : "auction-server-1.2-sandbox-1-t12-1387962585-0-702",
   "imp" : [
      {
         "bidfloor" : 800,
         "id" : "impid123",
         "tagid" : "19",
         "video" : {
            "h" : 480,
            "linearity" : 1,//广告展现样式
            "minduration":1,//视频广告最短播放时长，单位是秒
            "maxduration":15,//视频广告最长播放时长，单位是秒
            "mimes" : ["video/x-flv"],//广告位允许的素材类型
            "w" : 640
         },
         "pmp": { // Deal
             "deals" : [
             {
                 "id": "1",
                 "at": 1
             }
             ]
         }
      }
   ],
   "device" : {
      "ip":"192.168.1.226",
      "ua":"Mozilla/5.0 (Windows NT 5.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/31.0.1650.63 Safari/537.36",
      "didmd5":"d41d8cd98f00b204e9800998ecf8427e",
      "os":"Windows",
      "osv":"XP",
      "devicetype":2
    },
   "site" : {
      "name" : "“阿里妈妈全域媒体”网",
      "content" : {
         "title": "Big Bang Theory",
         "keywords": "Sitcom|Funny"
         "ext" : {
            "channel": "1",
            "cs": "2"
         }
      }
   },
   "user" : {
      "id" : "1393314446719HTx"
      "tag":{
          "1": 50,
          "2": 50
      }
   }
}

{
    "id":"v1.2-test-1-t12-1396427099-0-779",
    "device":{
      "ip":"192.168.1.226"
      "didmd5":"d41d8cd98f00b204e9800998ecf8427e",
      "os":"Windows",
      "ua":"Mozilla/5.0(iPhone;CPUiPhoneOS6_0likeMacOSX)AppleWebKit/536.26(KHTML,likeGecko)Version/6.0Mobile/10A403Safari/8536.25",
      "devicetype":0,
      "os":"iOS",
      "idfa":"B919E320-3140-4290-B2B3-B4D8C75A272F",
      "make":"apple",
      "carrier":"4",
      "connectiontype":2,
      "model":"iPhone4,1",
      "mac":"02:00:00:00:00:00",
      "screenwidth":"640",
      "screenhight":"960",
    },
    "user":{
        "id":"1393309862708emQ"
    },
    "app":{
        "name":"“优酷”客户端",
        "content":{
            "title":"%E7%94%B5%E8%A7%86%E5%89%A7",
            "ext":{
                "channel":"d",
                "cs":"2038"
            }
        }
    },
    "imp":[
      {
        "id":"35829dda8b5642f99d5dd4c6e3628dbe",
        "tagid":"19",
        "bidfloor":13400,
        "video": {
          "w":640,
          "h":480,
          "mimes":["video/x-flv"],
          "linearity":1,
          "minduration":1,
          "maxduration":15
        }
      }
    ]
 }

{
    "id": "a12-0ASh-03PFKt-0RV-2OR",
        "app": {
            "name": "“优酷”客户端",
            "content": {
                "keywords": "关键词",
                "title": "视频标题",
                "ext": {
                    "channel": "c",
                    "usr": "97454045",
                    "cs": "2034",
                    "vid": "420613008",
                    "s": "306281"
                }
            }
        },
        "device": {
            "androidid": "d097a86f3f9dd712",
            "make": "OPPO",
            "screenwidth": "1080",
            "carrier": "1",
            "connectiontype": 2,
            "model": "OPPO R9m",
            "screenhight": "1920",
            "mac": "cc:2d:83:16:fd:d0",
            "ua": "Youku;5.10.1;Android;5.1;OPPO R9m",
            "imei": "862965038483716",
            "ip": "49.77.178.130",
            "devicetype": 0,
            "osv": "5.1",
            "idfa": "",
            "os": "Android",
            "didmd5": "e79efc200a79a4a5cf511829e5c1e52a"
        },
        "imp": [{
            "bidfloor": 1650,
            "id": "055f797a16e807d05027e0b4b945d7c9",
            "pmp": {
                "deals": [{
                    "at": 1,
                    "id": "01402729"
                }]
            },
            "video": {
                "h": 480,
                "startdelay": 0,
                "w": 640,
                "mimes": ["video/x-flv"],
                "minduration": 13,
                "linearity": 1,
                "maxduration": 16
            },
            "tagid": "55"
        }],
        "user": {
            "id": "862965038483716"
        }
}

{
    "id": "a01-00SD-02h1tX-001-0Vf",
    "imp": [{
        "id":"2015f1d9dc6f6e317cf91c3c7e07345b",
        "tagid":"201",
        "bidfloor":200,
        "native":{
            "native_template_ids":["1","3"],  //原生广告位模板ID
            "assets":[{             //原生广告模板规则定义
                "native_template_id":"1",
                "title":{
                    "len":8
                },
                "image_url":{
                    "w":1280,
                    "h":720,
                    "mimes":["image/jpg","image/png"]
                },
            },{
                "native_template_id":"3",
                "title":{
                    "len":10
                },
                "image_url":{
                    "w":600,
                    "h":500,
                    "mimes":["image/jpg","image/png"]
                },
            }],
        },
    }],
    "app": {
        "content": {
            "keywords": "中国",
            "title": "中国人名",
            "ext": {
                "channel": "u",
                "usr": "93129229",
                "cs": "",
                "vid": "108066107",
                "s": ""
            }
        },
        "name": "“优酷”客户端"
    },
    "device": {
        "androidid": "43debaa64c42eeb7",
        "screenhight": "1920",
        "ua": "Youku;5.5;Android;5.1;m1metal",
        "mac": "",
        "idfa": "",
        "carrier": "5",
        "devicetype": 0,
        "connectiontype": 2,
        "didmd5": "f0577d676559ee51588fe5b5f85f3c26",
        "make": "Meizu",
        "os": "Android",
        "screenwidth": "1080",
        "imei": "868024029860260",
        "osv": "5.1",
        "ip": "125.111.101.163",
        "model": "m1metal"
    },
    "user": {
        "id": "868024029860260"
    }
}

{
    "id":"auction-server-1.2-sandbox-1-t12-1387962585-0-702",//竞价请求ID(对应Bid Request中的id)
    "bidid":"100002_200004_1000014",//DSP给出的该次竞价的ID
    "seatbid":[{//注意第一层数组  DSP出价
        "bid":[{//注意第二层数组 针对单次曝光的出价
            "adm":"http://xxx.jpg",
            "id":"100002_200004_1000014_0",//DSP对该次出价分配的ID
            "impid":"297902be955e49a291bcc44c7f13448c",//Bid Request中对应的曝光ID
            "nurl":"http://test.xxx.com?id=${AUCTION_ID}&bidid=${AUCTION_BID_ID}&impid=${AUCTION_IMP_ID}&price=${AUCTION_PRICE}",//目前nurl支持这四个宏替换
            "price":600,//DSP出价，注意单位是分/千次曝光，即CPM
            "crid":"1000014",//投放动态创意(即c类型的素材),需添加该字段
            "ext":{
                "ldp":"http://ss.thinkworld.com.cn/",
                "pm":["http://test.xxx.com"],//注意曝光监测url是数组
                "cm":["http://test.xxx.com"],//注意点击监测url是数组
                "em":["http://test.xxx.com"],//注意点击监测url是数组
                "tm":[{"t":5,"url":"http://test.xxx.com"},{"t":10,"url":"http://test.xxx.com"}]//
            }
        }]
    }]
}

{
    "id":"a01-00SD-02h1tX-001-0Vf",
    "bidid":"dsp_bid_id_0001",
    "seatbid":[{
        "bid":[{
            "id":"dsp_imp_id_0001",
            "impid":"2015f1d9dc6f6e317cf91c3c7e07345b",
            "price":100.23,
            "crid":"dsp_creative_id_0001",  //DSP创意id，保证在DSP侧的id唯一性
            "nurl":"http://xxx.xxx.xxx/1x1.gif?requestid=110&price=xkjlkd",
            "type":"x" //动态创意必须返回（暂时只支持内部渠道）,
            "native":{
                "native_template_id":"1",     //DSP response native template id
            },
            "ext":{
                "ldp":"http://www.youku.com",
                "pm":["http://yes.youku.com"],
                "cm":["http://yes.youku.com"],
            }
        }]
    }]
}