流量交易服务api接口2.8pcmobilevideo

API概 API基本结 URL定 API请 API响 请求IP限 指 2.1 新 修 按ID查 新 修 按ID查 创意预览URL获取（仅web流量使用 批量添加批量删除excluded_landing_page_url文 过滤设置文件 本文将介绍如何使用API与流量交易服务系统进行交互。在流量交易服务API的支持下，您APIAPIJsonHTTPContent-Typeapplication/json，通过HTTPS协议交换信息。料，同时也是流量交易服务API的数据类型。API方法的操作对象就是资源。在API中资源的唯一标机API通过用户ID（dspid）以及令牌（token）来做权限验证，信息需要包含在API请求头中，具体见1.5.2小节。编码参数编码请使用UTF-8请求API 其中例如 表示新增创意APIAPIHTTPbodyJsonbody{{{{"request":{"creativeUrl":"targetUrl":"monitorUrls":["creativeId":"advertiserId":"state":"type":"type":"height":"width":{"creativeUrl":"targetUrl":"ht "landingPage":"http "monitorUrls":[ "creativeId":"advertiserId":"state":0,"type":"height":"width":}]}API特别注意：部分新增、修改类型的API支持批量操作，因此允许部分成功的情况。例如10个创意，成功9个，则errors中只含有一个错误信息，其他9个上传成功，请开发者注意避免重复提交导致的错误index0{"status":2,"errors":{"field":"message":"Invalidorduplicatecreativeid","index":0,"code":{"field":"message":"Invalidorduplicatecreativeid","index":1,"code":}]}IP请http: ，在WEB端的【设置】->【DSP接入设置】中设置。主 {"request":{"request":{"advertiserId":101,"advertiserLiteName":"name1""advertiserName":"name1"“siteName":"sitename1"是是是否请确保此名称与客户上的名称一致，名否URL否512个字节，必须以http否否白否 是"siteUrl": "address":{"advertiserId":105,"advertiserLiteName":"name5""advertiserName":"name5"“siteName":"sitename5""siteUrl": "address":}{}}特别说一般情况，请先添加主，才可以上传创意，因为创意需要指定主 是是此id为dsp系统的主id，需告主id否否名否否否否否此字段在请求时不需要填写且不生是{"request":{"request":{"advertiserId":"siteUrl": "address":{"advertiserId":"siteUrl": "address":}{}} 是是{{{}}ID 是无是{[1003,{}}特别说API不会返回查询不到ID的主，请确认查询ID正确且存在 是无是BES原因通过refuseReason明BES检查未通过理由无流量方检查原因通过refuseReason流量方检查{[1003,{}}查询开放状 否 否 {}"open{}"open{" }}{}{ }{}"token":"bac98f4cda62xxxxxxxxxxxxxxxx",}{{ }]}创 是是—否1：Web流量 2；如果投放是adviewType2只能为1；当adviewType为3时，该字段只能为3；get/getAll/queryAuditState创意否地址，抓取或者flash创意。请确保URL可连通并且可以通过HTTP协议在网问到。否binaryData的处理优先级高于adviewType2时，且创意640*960、480*800adviewType2时，且创意640*960、480*800展现监测链是3是当adviewType为2当adviewType为3是adviewType1当adviewType为2时：见mobile当adviewType为3创意所属行是是否署的框架协议id。如果主给出框架id并且要求adviewType21：直当adviewType为2且 当adviewType为2且当adviewType为2且 当adviewType为2且否adviewType3的码流，单位是否adviewType3的时长，单位是否是{{{"token":"request":{"targetUrl":null,[ ""creativeId":"state":0,"type": "dataRate"duration"playTime}]} 是是—否1：Web流量 否adviewType2只能为1；当adviewType为3时，该字段只能为3；1：2：h：get/getAll/queryAuditState创意否地址，抓取或者flash创意。请确保URL可连通并且可以通过HTTP协议在网问到否binaryData的处理优先级高于否否展现监否3否当adviewType为2时：见当adviewType为3否adviewType1当adviewType为2时：见mobile流量创意尺寸补充说明；当adviewType为3创意所属广否否否此处的框架id指主与签署的框架协议id。如果主给出框架id并且要求将在的投放计入框架，那么否adviewType21：直否当adviewType为2且如01088888888、 否当adviewType为2且否当adviewType为2且否当adviewType为2且否当adviewType为2且否adviewTpye3的码流，单位是否adviewTpye3的时长，单位是否是不允许修改主id{{{"request":{"creativeTradeId": "appDesc":"这是一段更新后的应用介绍}]}特别一般情况，可以指定需要修改的字段，其他字段留空即可若要修改，则必须重新指定type、hight、width参数，否则不应该指定type、hight、width 是限制：时间跨度不得大于30天默认为1是{{}}ID 是无是{{[1003,{}}特别说API不会返回查询不到ID的创意，请确认查询ID正确且存 是无是原因通过refuseReasonBES原因通过refuseReason{[1003,{}}查询修正过的创意及行 否限制：时间跨度不得大于7非必填1：Web流量默认为1否 Creative中的{"startDate":"2014-03-"endDate":"2014-03-}}{{{}}{"startDate":"2014-03-"endDate":"2014-03-}}{{"message":"Daterangeittoobig,trytonarrowthedaysbetweenstartDateandendDate",}]}查询指定时段内被检查的动态创 否大于30天。否{{{"startDate":"2014-05-"endDate":"2014-05-{{{"refuseReasons":"url无法"网盟业务"内容及 ]}"status":}URL获取（仅web流量使用 否否 和10个创意id。{{{ {"creativePreviewList":{"creativePreviewList":{ ":"creativeId":"previewUrl": }"status":}}特别说因为位变动或者其他原因，给定的url在预览时会存在较低比例的预览失败报 否是是否2：Mobile流量 否实际发送1：Web流量3：力量{{}{{"adviewType":2,}{{"adviewType":1,} 否 是必填，从2013-05- 是否2：Mobile流量 否例如：27.5627561：Web流量3：流量{{"token":"}}{{"adviewType":1,}{{"adviewType":2,} 否 是必填，从2013-05- 是否2：Mobile流量 否例如：27.5627562：Mobile {{}{{"adviewType":1,}{{"adviewType":2,}s（PC流量使用 否 sList< 格式参考：1390370647017，即非必填，默认自上传日期开始，7天后失效 否 ss {{"dspId":"token": s":{ "expireDate":" "expireDate":}]} 否 sList< 否 ss {{{{"dspId":"token": s":{ Id":"145df362-a154-4a75-8d6f- Id":"b8b41412-bd36-461e-a4d1-}]}excluded_landing_page_url / 否无 否 MD5无{{"dspId":"token":}}APPID和名称对应表文 （仅ol流量使用 否无否MD5无{{"dspId":"token":}}AppId和AppNametab开发者ID和名称对应表文 （仅ol流量使用 否无否MD5无{{"dspId":"token":}}返回文件：文件中包含PublisherId和PublisherNametab过滤设置文件 否无否MD5无{{"dspId":"token":}}setting.data1 否投放 是否 是否是 俗是 注：当请求中有多个设置ID时，需要符合所有ID的设置要系统SysteminnerRequestparamtypeHTTPrequestmediatypenotHTTPcontenttypeHTTPrequestmethodHTTPPOSTJsonparameter请求jsonAuthheaderisDspidisDspidIPisnotinallowedIPAccesstoofrequent,pleasetryagainAPIprivilegerevoked,pleasecontact公共ParameterisParameternumberexceedstheDateparameterpatternDaterangeittoobig,trytonarrowthedaysbetweenstartDateandendDate服务器处理数量过主Advertiseridis主IDAdvertisernameisAdvertiseridisAdvertisersiteNameisAdvertisersiteUrlis主urlAdvertiseraddressis ephoneis主AdvertiserlitenameisAdvertiserlitenameisDatabasehasthesame创CreativetypeisUnauthorizetothespecifiedInvalidorduplicatecreativeInvalidtradeInvalidheightMonitorurlnumexceedUrlisUrlmuststartwithUrlcontainsinvalidUrlcharacterisUrllengthexceedsCreativeUrlmustendswithvalidsuffixincluding创意URL后缀错EitherbinaryDataorcreativeUrlmustbeCreativepicturesizeexceedsCreativeflashsizeexceeds创意flashCreativepicturefiletypeCreativeflashfiletype创意flashCreativefiledeclaredvalueCreativepicturefiletypeisnotUrlcontainsrestrictedUrlprefixUrlsuffixTypecannotbeupdatedonlyifbinaryDataorcreativeUrlspecified或者flashTypeshouldnot或者flash时，HeightorwidthcannotbeupdatedonlyifbinaryDataorcreativeUrlspecified或者flashorcreativeUrlspecified必CreativewiththespecifiedidnotFailedtodownloadcreativefromspecifiedAgreementnumberAgreementnumberidTargetUrlforwardsmorethan33 CreativeflashfilemadebyadmakerisnottemporarilysupportedReacheddailypreviewThespecifiedcreativelistisThespecifiedcreativelistgtmaxThespecifiedcreativelistisnotADviewtypeisInteractive