美团API接口.docx

1、美团API接口美团API接口定义文档历史版本时间状态作者备注1.02014年4月26日初稿李冬冬创建 10. VOUCHER表-代金券.4一模板表1.CATEGORY表-大分类category字段定义父级描述category_idcategory大分类idmerchart_idmerchart商家idcategory_titlecategory大分类标题2.CITY表-城市city字段定义父级描述city_idcity城市idcity_namecity城市名称city_loncity城市经度city_lancity城市纬度3.COLLECTS表-场次collects字段定义父级描述collec

2、ts_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表

3、-商家merchart字段定义父级描述merchart_idmerchart商家idmerchart_informationmerchart商家信息merchart_photomerchart商家相册category_idcategory大分类idcity_idcity城市idmerchart_titlemerchart商家标题merchart_telemerchart商家电话merchart_addressmerchart商家地址merchart_lonmerchart商家经度merchart_latmerchart商家纬度merchart_isGroupBuymerchart商家是否团购s

4、ubCategory_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下单时

5、间order_totalordersorder_deadlineorders订单截止日期7.RODUCT表-应用软件product字段定义父级描述product_idprouct商品idproduct_userGuizeprouctproduct_useTimeprouctproduct_guoqiBackprouctproduct_suishiBackprouctproduct_timeprouctmerchart_idmerchart商家idproduct_oldpriceprouct商品原来价格product_yuyueprouct商品是否预约category_idcategory大分类

6、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_freedat

7、eprouct8.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字段

8、定义父级描述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

9、用户密码是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:

10、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收藏id

11、collects_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三错误代码对照表错误返回格式

12、成功的话 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限制不能请求该资源1000

13、5Permission 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 e

14、rrorRPC错误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文档1

15、0018Request 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 null手机的操作系统平台不能为空20101暂时没有数据20102签到过于频繁四API用例列表API参数说明API参数中String类型的参数可以=，等效于不传该参数。API参数中Int类型的参数可以=-1，等效于不传该参数。API用例列表API名称API用例基础信息接口获取影片信息 按照城市id获取影片列表 活动接口XX接口