美团API接口.doc

美团api接口定义文档历史版本时间状态作者备注1.02014年4月26日初稿李冬冬创建目录美团api接口定义1文档历史1一模板表11.category表-分类12.city表-城市13.collects表-收藏24.comments表-评论25.merchart表-商家36.orders表-订单37.product表-商品38.subcategory表-小分类49.users表-用户4 10. voucher表-代金券.4二接口详细定义51.获取已注册用户信息52.获取影片信息73.获取城市下正在热映影片列表104.获取城市下即将上映影片列表125.获取影片下的在映影院列表146.获取影院信息167.获取城市下影院列表198.获取影院场次列表（按影片或默认）229.获取影院场次列表（按时间）2610.获取活动列表2811.获取影片评论列表2912.发表影片评论3013.获取应用软件列表3114.更改关注状态3215.获取关注影院列表3216.获取用户参与的活动列表3517.用户参加活动3518.获取用户信息3619.用户更新信息37三api用例列表39api参数说明39api用例列表399一 模板表1. category表-大分类category字段定义父级描述category_idcategory大分类idmerchart_idmerchart商家idcategory_titlecategory大分类标题2. city表-城市city字段定义父级描述city_idcity城市idcity_namecity城市名称city_loncity城市经度city_lancity城市纬度3. collects表-场次collects字段定义父级描述collects_idcollects收藏iduser_idusers用户idcollects_typecollects收藏类型collects_product_merchart_idcollects收藏商品或者商家的id4. comment表-评论comment字段定义父级描述comment_idcomment评论idcomment_starsumcomment评论数目user_idusers用户idmerchart_idmerchart商家idproduct_idproduct商品idcomment_contentcomment评论内容comment_timecomment评论时间5. merchart表-商家merchart字段定义父级描述merchart_idmerchart商家idmerchart_informationmerchart商家信息merchart_photomerchart商家相册category_idcategory大分类idcity_idcity城市idmerchart_titlemerchart商家标题merchart_telemerchart商家电话merchart_addressmerchart商家地址merchart_lonmerchart商家经度merchart_latmerchart商家纬度merchart_isgroupbuymerchart商家是否团购subcategory_idsubcategory小分类idprice_youmerchart商家商品价格merchart_price_youhuimerchart商家商品优惠价格merchart_imagesmerchart商家图片merchart_wifymerchart商家是否有wifymerchart_jieshaomerchart商家介绍6. orders表-订单orders字段定义父级描述order_idorders订单iduser_idusers用户idproduct_idproduct商品idorder_numberorders订单数目order_pay_timeorders下单时间order_totalordersorder_deadlineorders订单截止日期7. roduct表-应用软件product字段定义父级描述product_idprouct商品idproduct_userguizeprouctproduct_usetimeprouctproduct_guoqibackprouctproduct_suishibackprouctproduct_timeprouctmerchart_idmerchart商家idproduct_oldpriceprouct商品原来价格product_yuyueprouct商品是否预约category_idcategory大分类idorder_idorders订单idsubcategory_idsubcategory小分类idproduct_titleprouct商品标题product_priceprouct商品价格product_numprouct商品数目product_notifyprouct商品通知product_new_notifyprouct商品最新通知product_imagesprouct商品图片product_isgroupbuyprouct商品是否团购product_valid_timeprouct商品有效期时间product_istodayprouct商品是否是今天的product_freedateprouct8. subcategory表-关注subcategory字段定义父级描述subcategory_idsubcategory小分类idcategory_idcategory大分类idsubcategory_titlesubcategory小分类标题9. uers表-用户users字段定义父级描述user_idusers用户iduser_collect_numusers用户收藏数量user_nameusers用户名称user_nicknameusers用户昵称user_passwordusers用户密码user_teleusers用户电话10. voucher表-优惠券voucher字段定义父级描述voucher_idvoucher优惠券iduser_idusers用户idvoucher_passwordvoucher优惠券密码voucher_deadlinevoucher优惠券截止日期二 接口详细定义1. 获取已注册用户信息（登录时返回的用户信息）1) api 格式：http:/localhost:8080/meituan/user?user_name=zhoubibi&user_password=123&type=12) 请求方式：get post3) url入口参数说明：keyvalue值含义是否必须user_namestring用户名称是user_passwordstring用户密码是typeint操作类型是4) 返回类型：json5) 返回参数说明：key上级keyvalue类型含义addsuccessboolean用户是否注册成功user_collect_numint用户收藏数量user_idint用户iduser_namestring用户名称user_nicknamestring用户昵称user_passwordstring用户密码user_telestring用户电话6) 例：请求 http:/localhost:8080/meituan/user?user_name=zhoubibi&user_password=123&type=1返回addsuccess: true,user_collect_num: 0,user_id: 6,user_name: zhoubibi,user_nickname: ,user_password: 123,user_tele: 2. 获取某用户的所有收藏1) api格式：http:/localhost:8080/meituan/collect?user_id=1&type=12) 请求方式：get post3) url入口参数说明：keyvalue值含义是否必须user_idint用户id是typeint操作类型是4) 返回类型：json5) 返回参数说明：key上级keyvalue类型含义collects_idint收藏idcollects_product_merchart_idint收藏商品或者商家的idcollects_typeint收藏类型user_idint用户id6) 例：请求http:/localhost:8080/meituan/collect?user_id=1&type=1返回collects_id: 1,collects_product_merchart_id: 2,collects_type: 1,user_id: 1,collects_id: 2,collects_product_merchart_id: 1,collects_type: 1,user_id: 1三 错误代码对照表错误返回格式成功的话 status:200respond: status: 500, code: 0, msg: success错误的话 status:500，code为错误代码respond: status: 500, code: 10008, msg: 参数错误respond: status: 500, code: 20101, msg: 暂时没有数据系统级错误代码错误代码错误信息详细描述10001system error系统错误10002service unavailable服务暂停10003remote service error远程服务错误10004ip limitip限制不能请求该资源10005permission denied, need a high level appkey该资源需要appkey拥有授权10006source paramter (appkey) is missing缺少source (appkey) 参数10007unsupport mediatype (%s)不支持的mediatype (%s)10008param error, see doc for more info参数错误，请参考api文档10009too many pending tasks, system is busy任务过多，系统繁忙10010job expired任务超时10011rpc errorrpc错误10012illegal request非法请求10013invalid weibo user不合法用户10014insufficient app permissions应用的接口访问权限受限10016miss required parameter (%s) , see doc for more info缺失必选参数 (%s)，请参考api文档10017parameter (%s)s value invalid, expect (%s) , but get (%s) , see doc for more info参数值非法，需为 (%s)，实际为 (%s)，请参考api文档10018request body length over limit请求长度超过限制10020request api not found接口不存在10021http method is not suported for this request请求的http方法不支持10022ip requests out of rate limitip请求频次超过上限10023user requests out of rate limit用户请求频次超过上限10024user requests for (%s) out of rate limit用户请求特殊接口 (%s) 频次超过上限服务级错误代码错误代码错误信息详细描述20001device os must be not nul