阿里妈妈淘客系统对外接口通用规范.docVIP

PAGE PAGE 1 阿里妈妈 淘客系统对外接口通用规范 目录 TOC \o 1-3 \h \z \u TOC \o 1-2 \h \z \u 阿里妈妈 淘客系统对外接口通用规范 1 Revision History 1 1.关于本文档 3 1.1读者对象 3 1.2背景介绍 3 1.3其他说明 3 2.调用规范 4 2.1 消息编码 4 2.2请求方式 4 2.3查询广告信息接口 4 2.4类目同步接口 6 2.5查询点击串接口 7 2.6根据ID查询广告信息接口 8 1.关于本文档 本文档是对阿里妈妈淘客系统对外合作接口的通用规范介绍。我们通过统一的访问约束和规范，帮助各合作伙伴调用、测试自己所需要的服务。 1.1读者对象 各合作伙伴。 1.2背景介绍 由于合作伙伴的增多，为了更好的帮助各合作伙伴、更好的推广淘客系统、更快的实现合作伙伴需求，阿里妈妈淘客系统采用统一规范来实现充分的合作。 1.3其他说明 合作伙伴提供： 如果合作伙伴为淘客，提供注册阿里妈妈的邮件地址。 阿里妈妈提供： 合作伙伴密码 如果合作伙伴为淘客，提供淘客id 2.调用规范 请严格按照规范调用接口。 2.1 消息编码 统一采用GBK的编码 2.2请求方式 所有接口请求全部采用http请求 建议采用GET方式请求 例1：GET请求类目同步 Get /rpc/ searchAuctionByRpc.do?pw=xxxx 2.3查询广告信息接口 实时查询广告，根据需求返回结果。 2.3.1请求限制 300/3毫秒查询一次。 限制时间内查询返回信息： QUERYRESULTTIMEOUT/QUERYRESULT 2.3.2返回形式 Xml文件形式 2.3.3请求URL及参数定义 查询广告接口请求地址： /rpc/searchAuctionByRpc.do?pw=nnnnjjjjj jjjj为参数 2.3.4输入参数 输入参数 url段 是否必须 说明 pw 必须 密码 rowoffset 必须 查询记录的起始位置 rowcount 必须 查询记录条数，最大限制40条 catid 二者不可全部为空 查询中选择的类目 keyword 查询的关键字 mid 可选 是否是查掌柜 0：按宝贝查询（默认）1:按掌柜查询 sr 可选 排序号1－10 排序方式 值 说明 1 按成交佣金从高到低 2 按成交佣金从低到高 3 按总支出佣金从高到低 4 按总支出佣金从低到高 5 按佣金比率从高到低 6 按佣金比率从低到高 7 按商品单价从高到低 8 按商品单价从低到高 9 按累计推广量从高到低 10 按累计推广量从低到高 2.3.5输出参数 根据合作伙伴需求进行输出。 以下为全部可以输出的内容。 QUERYRESULT PTOTAL查询结果数量/PTOTAL PRESULTS PRESULT SERVICEID广告id/SERVICEID TITLE广告标题/TITLE DESC广告描述/DESC ALT图片后面的提示文字 /ALT RESOURCETYPE 资源类型/RESOURCETYPE RESOURCEPATH宝贝图片地址/RESOURCEPATH MEMBERID掌柜在alimama的编号/MEMBERID CATID类目id/CATID CATNAME类目名称/CATNAME ORITYPE宝贝类型/ORITYPE PRICE宝贝价格（分）/PRICE COMMISIONRATE佣金比例/COMMISIONRATE SHOPCOMMISIONRATE全店佣金比例/ SHOPCOMMISIONRATE COMMISION佣金（分）/COMMISION CONTACT店铺名称/CONTACT ORIOBJID宝贝id/ORIOBJID ORIMEMBERID掌柜id（店铺id）/ORIMEMBERID TOTALCLICK总点击量/TOTALCLICK TOTALCOST总销售/TOTALCOST TOTALACTION总成交量/TOTALACTION UPDATETIME（修改时间）/UPDATETIME EURL链接地址/EURL CLICKINFO点击串/CLICKINFO RANK_SCORE综合排名/RANK_SCORE DETAIL_URL淘宝链接地址/DETAIL_URL TAOBAO_INFO淘宝相关信息url地址/ TAOBAO_INFO /PRESULT /PRESULTS STATISTIC PAIR CATID类目id/ CATI