《美团API接口.doc》由会员分享，可在线阅读，更多相关《美团API接口.doc（12页珍藏版）》请在三一办公上搜索。
1、美团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.获取影院信息
2、167.获取城市下影院列表198.获取影院场次列表（按影片或默认）229.获取影院场次列表（按时间）2610.获取活动列表2811.获取影片评论列表2912.发表影片评论3013.获取应用软件列表3114.更改关注状态3215.获取关注影院列表3216.获取用户参与的活动列表3517.用户参加活动3518.获取用户信息3619.用户更新信息37三API用例列表39API参数说明39API用例列表39一 模板表1. CATEGORY表-大分类category字段定义父级描述category_idcategory大分类idmerchart_idmerchart商家idcategory_titlec
3、ategory大分类标题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_s
4、tarSumcomment评论数目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商
5、家标题merchart_telemerchart商家电话merchart_addressmerchart商家地址merchart_lonmerchart商家经度merchart_latmerchart商家纬度merchart_isGroupBuymerchart商家是否团购subCategory_idsubcategory小分类idprice_youmerchart商家商品价格merchart_price_youhuimerchart商家商品优惠价格merchart_imagesmerchart商家图片merchart_wifymerchart商家是否有wifymerchart_jieshao
6、merchart商家介绍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_guoqiBackprouct
7、product_suishiBackprouctproduct_timeprouctmerchart_idmerchart商家idproduct_oldpriceprouct商品原来价格product_yuyueprouct商品是否预约category_idcategory大分类idorder_idorders订单idsubCategory_idsubcategory小分类idproduct_titleprouct商品标题product_priceprouct商品价格product_numprouct商品数目product_notifyprouct商品通知product_new_notifyp
8、rouct商品最新通知product_imagesprouct商品图片product_isGroupBuyprouct商品是否团购product_valid_timeprouct商品有效期时间product_isTodayprouct商品是否是今天的product_freedateprouct8. SUBCATEGORY表-关注subcategory字段定义父级描述subCategory_idsubcategory小分类idcategory_idcategory大分类idsubCategory_titlesubcategory小分类标题9. UERS表-用户users字段定义父级描述user_
9、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:/localho
10、st: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_nicknameS
11、tring用户昵称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/meitu
12、an/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返回collect
13、s_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:
14、 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
15、 (%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) , se
16、e 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 r
17、equests 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接口
