Changes between Version 25 and Version 26 of buygo_jiekou


Ignore:
Timestamp:
07/09/2013 05:18:16 PM (13 years ago)
Author:
wenshaohong
Comment:

编辑v1.0

Legend:

Unmodified
Added
Removed
Modified

  • buygo_jiekou

    v25 v26  
    1616            "id": "店铺或商品ID", 
    1717            "url": "商品URL", 
    18                 "type": "IT_SHOP|TAO_PRODUCT|IT_PRODUCT"//(店铺、淘宝商品、IT商场商品) 
     18                "type": "IT_SHOP|IT_PRODUCT"//(店铺、IT商场商品) 
    1919        } 
    2020    ], 
    … …  
    3535 
    3636== 2.店铺接口 == 
    37 * '''店铺简介:/shopIntro''' [[BR]] 
    38   接口类型:数据接口 [[BR]] 
    39   数据格式:JSON [[BR]] 
    40   请求方式:GET [[BR]] 
    41   要求登录:否 [[BR]] 
    42   参数：companyId:店铺的ID [[BR]] 
     37* '''店铺列表:/listShop''' [[BR]] 
     38  接口类型:数据接口 [[BR]] 
     39  数据格式:JSON [[BR]] 
     40  请求方式:GET [[BR]] 
     41  要求登录:否 [[BR]] 
     42  参数：pageNo;pageSize,排序参数待定 [[BR]] 
    4343  返回数据： [[BR]] 
    4444{{{ 
    45 { 
    46     "id": "店铺Id", 
    47     "tile": "店铺标题", 
    48     "rate": "店铺信誉", 
    49     "star": "旗舰店标记,旗舰店为1，其他为0" , 
    50     "focusList": [ 
    51         { 
    52             "image": "焦点图", 
    53             "id": "商品ID", 
    54             "url": "商品URL", 
    55             "type": "TAO_PRODUCT|IT_PRODUCT"//淘宝商品、IT商场商品 
    56         } 
    57     ](焦点图暂时保留，不出现在店铺介绍中) 
    58 } 
    59 }}} 
    60  
    61 * '''店铺详情:/shopInfo''' [[BR]] 
     45[ 
     46        { 
     47        "id": "店铺Id", 
     48        "tile": "店铺标题", 
     49        "rate": "店铺信誉", 
     50        "isFlagShip": "是否为旗舰店", 
     51        "focusList": [ 
     52                { 
     53                "image": "焦点图", 
     54                "name": "名称" 
     55                } 
     56                ] 
     57        } 
     58] 
     59}}} 
     60 
     61* '''店铺介绍:/shop''' [[BR]] 
    6262  接口类型:数据接口 [[BR]] 
    6363  数据格式:JSON [[BR]] 
    … …  
    7070    "id": "店铺id", 
    7171    "name": "店铺名", 
    72     "addr": "地区", 
     72    "addr": "地址", 
    7373    "long": "经度", 
    7474    "lat": "纬度", 
    7575    "logo": "店铺logo", 
    76     "service": "渠道服务", 
    7776    "credit": "老板信用", 
    78     "evaluation": "老板好评", 
    7977    "contact": "联系人", 
    8078    "phone": "联系电话" 
    … …  
    8280}}} 
    8381 
    84 * '''店铺商品筛选:/listShopProduct'''[[BR]] 
    85   接口类型:数据接口 [[BR]] 
    86   数据格式:JSON [[BR]] 
    87   请求方式:GET [[BR]] 
    88   要求登录:否 [[BR]] 
    89   参数：companyId:店铺的ID,bigId:大类ID(默认为-1),smallId:小分类ID(默认为-1),pageNo,pageSize [[BR]] 
     82* '''店铺商品分类:/listShopClassify'''[[BR]] 
     83  接口类型:数据接口 [[BR]] 
     84  数据格式:JSON [[BR]] 
     85  请求方式:GET [[BR]] 
     86  要求登录:否 [[BR]] 
     87  参数：companyId:店铺的ID,,其他参数选定 [[BR]] 
     88  返回数据： 选定[[BR]] 
     89   
     90* '''店铺筛选商品列表:/listShopProduct'''[[BR]] 
     91  接口类型:数据接口 [[BR]] 
     92  数据格式:JSON [[BR]] 
     93  请求方式:GET [[BR]] 
     94  要求登录:否 [[BR]] 
     95  参数：companyId:店铺的ID,pageNo,pageSize,其他参数选定 [[BR]] 
    9096  返回数据： [[BR]] 
    9197{{{ 
    92 { 
    93     "id": "商品id", 
    94     "name": "商品标题", 
    95     "price": "价格", 
    96     "url": "商品URL", 
    97     "type": "淘宝商品[typy为2]、IT商场商品[typy为1]", 
    98     "thumb": "商品缩略图" 
    99 } 
    100 }}} 
    101  
    102 * '''店铺商品分类:/shclassify''' [[BR]] 
    103   接口类型:数据接口 [[BR]]  
    104   数据格式:JSON [[BR]] 
    105   请求方式:GET [[BR]] 
    106   要求登录:否 [[BR]] 
    107   参数：companyId:店铺的ID [[BR]] 
    108   返回数据： [[BR]] 
    109 {{{ 
    110 [ 
    111     { 
    112         "bigId": "商品大类Id", 
    113         "bigName": "商品大类名称", 
    114         "subtypes": [ 
    115             { 
    116                 "smallId": "商品小类", 
    117                 "smallName": "商品小类名称" 
    118             } 
    119         ] 
    120     } 
    121 ] 
    122 }}} 
     98[{ 
     99        "id": "商品id", 
     100        "name": "商品标题", 
     101        "price": "价格", 
     102        "url": "商品URL", 
     103        "type": "IT_PRODUCT|TAO_PRODUCT(淘宝商品、IT商场商品)", 
     104        "thumb": "商品缩略图", 
     105        "shopid": "店铺Id", 
     106        "shoptitle": "店铺标题", 
     107        "shoprate": "店铺信誉" 
     108}] 
     109}}} 
     110 
    123111 
    124112== 3.商品接口 == 
    125 * '''商品概述:/productIntro''' [[BR]] 
    126   接口类型:数据接口 [[BR]]  
    127   数据格式:JSON [[BR]] 
    128   请求方式:GET [[BR]] 
    129   要求登录:否 [[BR]] 
    130   参数：productId:商品的ID      
    131   返回数据： [[BR]] 
    132 {{{ 
    133 { 
    134     "id": "商品的ID", 
    135     "durl": "产品详情的url", 
    136     "title": "商品标题", 
    137     "thumb": "商品缩略图", 
    138     
    139     "price": "价格", 
    140     "count": "已卖出数量", 
    141     "shopid": "店铺Id", 
    142     "shoptile": "店铺标题", 
    143     "rate": "店铺信", 
    144     "isStart": "是否为旗舰店"[旗舰店为1，其他为0] , 
    145     "fare": {//运费 
    146         "faretype": 1,//1:卖家包，0：自定义物流, 2:使用模板 
    147         "faredata": [ 
    148             { 
    149                 "id":"123", 
    150                 "name":"名称", 
    151                 "price":"价格" 
    152             } 
    153         ] 
    154     }, 
    155     "clist": [//颜色列表 
    156         { 
    157             "cid": "颜色Id", 
    158             "cname": "颜色名" 
    159         } 
    160     ], 
    161     "plist": [//套餐列表 
    162         { 
    163             "pid": "套餐Id", 
    164             "pname": "套餐名" 
    165         } 
    166     ], 
    167     "pricegroup": [//价格组合 
    168         { 
    169             "pcid":套餐组合Id 
    170             "cid": "颜色Id", 
    171             "pid": "套餐包Id", 
    172             "price": "价格" 
    173         } 
    174     ] 
    175 } 
    176 }}} 
    177113                                               
    178114* '''商品详情:/pdetail''' [[BR]] 
    … …  
    181117  请求方式:GET [[BR]] 
    182118  要求登录:否 [[BR]] 
    183   参数：productId:商品的ID 
    184  
    185 == 4.购买接口 == 
    186 * '''确认购买:/shopping''' [[BR]] 
    187   接口类型:Web跳转 [[BR]]  
    188   数据格式:HTML [[BR]] 
    189   请求方式:GET [[BR]] 
    190   要求登录:否 [[BR]] 
    191   参数： 
    192 {{{ 
    193 pid:商品Id 
    194 addressId:地址Id 
    195 count:数量 
    196 faretype:1,//0:卖家包，1：自定义物流, 2:使用模板 
    197 fareid:物流详情Id 
    198 specId:套餐组合Id 
    199 buyerId:顾客Id 
    200 question：留言 
    201 receiveName:收货人 
    202 phone:电话 
    203 }}} 
    204   返回结果:[[br]] 
    205     {{{ 
    206       payurl:跳转至支付页面 
    207 }}} 
    208  
    209 == 5.精准搜索接口 == 
     119  参数：productId:商品的ID，shopId:店铺ID,commonSessionId, 
     120 
     121== 4.精准搜索接口 == 
    210122 
    211123 * '''热门搜索词:/shot'''[[BR]] 
    … …  
    239151  返回数据： [[BR]]  
    240152{{{ 
     153[{ 
     154        "id": "商品id", 
     155        "name": "商品标题", 
     156        "price": "价格", 
     157        "url": "商品URL", 
     158        "type": "IT_PRODUCT|TAO_PRODUCT(淘宝商品、IT商场商品)", 
     159        "thumb": "商品缩略图", 
     160        "shopid": "店铺Id", 
     161        "shoptitle": "店铺标题", 
     162        "shoprate": "店铺信誉" 
     163}] 
     164}}} 
     165[[br]][[br]] 
     166 
     167 * '''搜索店铺:/searchShops'''[[BR]] 
     168 
     169  接口类型:数据接口 [[BR]] 
     170  数据格式:JSON [[BR]] 
     171  请求方式:GET [[BR]] 
     172  要求登录:否 [[BR]] 
     173  参数： [[BR]] 
     174{{{ 
     175   "words":关键词 
     176}}} 
     177  返回数据： [[BR]]  
     178{{{ 
     179[ 
     180        { 
     181        "id": "店铺Id", 
     182        "tile": "店铺标题", 
     183        "rate": "店铺信誉", 
     184        "isFlagShip": "是否为旗舰店", 
     185        "focusList": [ 
     186                { 
     187                "image": "焦点图", 
     188                "name": "名称" 
     189                } 
     190                ] 
     191        } 
     192] 
     193}}}                    
     194 
     195== 6.个人中心 == 
     196 
     197* '''买家收货地址列表:/addrs'''[[BR]] 
     198 
     199  接口类型:数据接口 [[BR]] 
     200  数据格式:JSON [[BR]] 
     201  请求方式:GET [[BR]] 
     202  要求登录:否 [[BR]] 
     203  参数：无 [[BR]] 
     204  返回数据： [[BR]]  
     205{{{ 
    241206[ 
    242207    { 
    243         "id": "商品id", 
    244         "name": "商品标题", 
    245         "price": "价格", 
    246         "url": "商品概述的url", 
    247         "type": "TAO_PRODUCT|IT_PRODUCT",//淘宝商品、IT商场商品 
    248         "thumb": "商品缩略图" 
    249     } 
    250 ] 
    251 }}} 
    252 [[br]][[br]] 
    253  
    254  * '''搜索店铺:/searchShops'''[[BR]] 
    255  
    256   接口类型:数据接口 [[BR]] 
    257   数据格式:JSON [[BR]] 
    258   请求方式:GET [[BR]] 
    259   要求登录:否 [[BR]] 
    260   参数： [[BR]] 
    261 {{{ 
    262    "words":关键词 
    263 }}} 
    264   返回数据： [[BR]]  
    265 {{{ 
    266 [ 
    267     { 
    268         "id": "店铺Id", 
    269         "tile": "店铺标题", 
    270         "rate": "店铺信誉", 
    271         "isFlagShip": "是否为旗舰店", 
    272         "addr": "地区" 
    273     } 
    274 ] 
    275 }}}                    
    276  
    277 == 6.个人中心 == 
    278  
    279 * '''买家收货地址列表:/addrs'''[[BR]] 
    280  
    281   接口类型:数据接口 [[BR]] 
    282   数据格式:JSON [[BR]] 
    283   请求方式:GET [[BR]] 
    284   要求登录:是 [[BR]] 
    285   参数：[id]:买家Id [[BR]] 
    286   返回数据： [[BR]]  
    287 {{{ 
    288 [ 
    289     { 
    290         "userId": "买家Id", 
    291         "addrId": "收货地址id", 
     208        "id": "买家Id", 
     209        "addrid": "收货地址id", 
    292210        "name": "收货人", 
    293211        "addr": "收货地址", 
    … …  
    326244[[br]][[br]] 
    327245 
    328   * '''删除收货地址:/delAddrs'''[[BR]] 
    329  
    330   接口类型:数据接口 [[BR]] 
    331   数据格式:JSON [[BR]] 
    332   请求方式:GET [[BR]] 
    333   要求登录:否 [[BR]] 
    334   参数： [[BR]] 
    335 {{{     
     246* '''删除收货地址:/delAddrs'''[[BR]] 
     247 
     248  接口类型:数据接口 [[BR]] 
     249  数据格式:JSON [[BR]] 
     250  请求方式:GET [[BR]] 
     251  要求登录:否 [[BR]] 
     252  参数： [[BR]] 
     253{{{ 
     254            "id":买家Id      ,       
    336255            "addrid":收货地址id      
    337256}}} 
    … …  
    343262}}} 
    344263[[br]][[br]] 
    345  
    346 * '''定单详情:/orderInfo'''[[BR]] 
    347  
    348   接口类型:数据接口 [[BR]] 
    349   数据格式:JSON [[BR]] 
    350   请求方式:GET [[BR]] 
    351   要求登录:否 [[BR]] 
    352   参数： [[BR]] 
    353 {{{ 
    354             "id":买家Id      ,       
    355             "orderId":定单ID"       
    356 }}} 
    357   返回数据： [[BR]] 
    358 {{{ 
    359 { 
    360     "productName": "商品名称", 
    361     "addr": "收货地址", 
    362     "price": "单价", 
    363     "count": "购买数量", 
    364     "fare": "邮费", 
    365     "totalPrice": "总价", 
    366     "orderNO": "IT商城详单号" 
    367 } 
    368 }}} 
    369 [[br]][[br]] 
    370      
    371 * '''已买到的商品: /bought'''[[BR]] 
    372  
    373   接口类型:数据接口 [[BR]] 
    374   数据格式:JSON [[BR]] 
    375   请求方式:GET [[BR]] 
    376   要求登录:否 [[BR]] 
    377   参数：无 [[BR]] 
    378   返回数据： [[BR]] 
    379 {{{ 
    380 [ 
    381     { 
    382         "id": "买家Id", 
    383         "productid": "商品的ID", 
    384         "url": "订单详情的url", 
    385         "pic": "商品缩略图", 
    386         "price": "价格", 
    387         "orderId": "定单id", 
    388         "status": "交易状态" 
    389     } 
    390 ] 
    391 }}}