美团API接口

美团 API 接口定义文档历史版本 1.0 时间 状态 作者 李冬冬 备注 创建

2014 年 4 月 26 日 初稿

目录美团 API 接口定义.................................................................................................................... 1 文档历史 ................................................................................................................................... 1 一. 1. 2. 3. 4. 5. 6. 7. 8. 9. 模板表 ........................................................................................................................ 1CATEGORY 表---分类 ...................................................................................................... 1

CITY 表---城市 ................................................................................................................ 1 COLLECTS 表---收藏 ....................................................................................................... 1COMMENTS 表---评论 .................................................................................................... 1 MERCHART 表---商家 ..................................................................................................... 2 ORDERS 表---订单 .......................................................................................................... 2

PRODUCT 表---商品 ....................................................................................................... 3 SUBCATEGORY 表---小分类 ........................................................................................... 3 USERS 表---用户............................................................................................................. 4

10. VOUCHER 表---代金券.........................................................................................................4

二. 1. 2. 3.

接口详细定义 ............................................................................................................ 4获取已注册用户信息 ................................................................... 错误！未定义书签。

获取影片信息................................................................................................................ 5 获取城市下正在热映影片列表 .................................................. 错误！未定义书签。

4. 5. 6. 7. 8. 9. 10. 11. 12. 13. 14. 15. 16. 17. 18. 19.

获取城市下即将上映影片列表 .................................................. 错误！未定义书签。 获取影片下的在映影院列表 ...................................................... 错误！未定义书签。 获取影院信息.............................................................................. 错误！未定义书签。 获取城市下影院列表.................................................................. 错误！未定义书签。 获取影院场次列表(按影片或默认) ........

.............................. 错误！未定义书签。 获取影院场次列表(按时间) .................................................. 错误！未定义书签。 获取活动列表 .......................................................................... 错误！未定义书签。 获取影片评论列表 .................................................................. 错误！未定义书签。 发表影片评论 .......................................................................... 错误！未定义书签。 获取应用软件列表 .................................................................. 错误！未定义书签。 更改关注状态 .......................................................................... 错误！未定义书签。 获取关注影院列表 .................................................................. 错误！未定义书签。 获取用户参与的活动列表 ...................................................... 错误！未定义书签。 用户参加活动 .......................................................................... 错误！未定义书签。 获取用户信息 .......................................................................... 错误！未定义书签。 用户更新信息 .......................................................................... 错误！未定义书签。

三.

API 用例列表 ............................................................................................................. 9

API 参数说明......................................................................................................................... 9 API 用例列表......................................................................................................................... 9

一. 模板表1. CATEGORY 表---大分类 category 字段定义 category_id merchart_id category_title 父级category merchart category 大分类 id 商家 id 大分类标题

描述

2. CITY 表---城市 city 字段定义 city_id city_name city_lon city_lan 父级city city city city 城市 id 城市名称 城市经度 城市纬度

描述

3. COLLECTS 表---场次 collects 字段定义collects_id user_id collects_type collects_product_merchart_id

父级 collects users collects collects

描述收藏 id 用户 id 收藏类型 收藏商品或者商家的 id

4. COMMENT 表---评论 comment 字段1

定义 comment_id comment_starSum user_id merchart_id product_id comment_content comment_time

父级 comment comment users merchart product comment comment

描述评论 id 评论数目 用户 id 商家 id 商品 id 评论内容 评论时间

5. MERCHART 表---商家 merchart 字段定义 merchart_id merchart_information merchart_photo category_id city_id merchart_title merchart_tele merchart_address merchart_lon merchart_lat merchart_isGroupBuy subCategory_id price_you merchart_price_youhui merchart_images merchart_wify merchart_jieshao 父级 merchart merchart

merchart category city merchart merchart merchart merchart merchart merchart subcategory merchart merchart merchart merchart merchart 描述商家 id 商家信息 商家相册 大分类 id 城市 id 商家标题 商家电话 商家地址 商家经度 商家纬度 商家是否团购 小分类 id 商家商品价格 商家商品优惠价格 商家图片 商家是否有 wify 商家介绍

6. ORDERS 表---订单 orders 字段定义 order_id user_id product_id 父级orders users product2

描述订单 id 用户 id 商品 id

order_number order_pay_time order_total order_deadline

orders orders orders orders

订单数目 下单时间 订单截止日期

7. RODUCT 表---应用软件 product 字段定义 product_id product_userGuize product_useTime product_guoqiBack product_suishiBack product_time merchart_id product_oldprice product_yuyue category_id order_id subCategory_id product_title product_price product_num product_notify product_new_notify product_images product_isGroupBuy product_valid_time product_isToday product_freedate 父级 prouct prouct prouct prouct prouct prouct merchart prouct prouct category orders subcategory prouct prouct prouct prouct prouct prouct prouct prouct prouct prouct 描述商品 id

商家 id 商品原来价格 商品是否预约 大分类 id 订单 id 小分类 id 商品标题 商品价格 商品数目 商品通知 商品最新通知 商品图片 商品是否团购 商品有效期时间 商品是否是今天的

8. SUBCATEGORY 表---关注 subcategory 字段定义 subCategory_id category_id 父级 subcategory category3

描述小分类 id 大分类 id

subCategory_titl e

subcategory

小分类标题

9. UERS 表---用户 users 字段定义 user_id user_collect_nu m user_name user_nickname user_password user_tele 父级users users users users users users 用户 id 用户收藏数量 用户名称 用户昵称 用户密码 用户电话

描述

10.

VOUCHER 表---优惠券 voucher 字段

定义 voucher_id user_id voucher_password voucher_deadline

父级voucher users voucher voucher 优惠券 id 用户 id 优惠券密码 优惠券截止日期

描述

二. 接口详细定义1. 获取已注册用户信息(登录时返回的用户信息)1) API 格式： http://localhost:8080/meituan/user?user_name=zhoubibi&user_password=123&type= 1 请求方式：GET POST URL 入口参数说明： Key Value 值 含义 是否必须4

2) 3)

user_name user_password type 4) 5) 返回类型：JSON 返回参数说明： Key addSuccess user_collect_num user_id user_name user_nickname user_password user_tele 6) 例：请求

String String Int

用户名称 用户密码 操作类型

是 是 是

上级 Key

Value 类型 boolean int int String String String String

含义 用户是否注册成功 用户收藏数量 用户 id 用户名称 用户昵称 用户密码 用户电话

http://localhost:8080/meituan/user?user_name=zhoubibi&user_p assword=123&type=1返回

[ { addSuccess: true, user_collect_num: 0, user_id: 6, user

_name: "zhoubibi", user_nickname: "", user_password: "123", user_tele: "" } ]

2. 获取某用户的所有收藏1) 2) 3) API 格式：http://localhost:8080/meituan/collect?user_id=1&type=1 请求方式：GET POST URL 入口参数说明：5

Key user_id type 4) 5) 返回类型：JSON 返回参数说明： Key collects_id

Value 值 Int Int

含义 用户 id 操作类型

是否必须 是 是

上级 Key

Value 类型 Int Int Int Int

含义 收藏 id 收藏商品或者商家的 id 收藏类型 用户 id

collects_product_merc hart_id collects_type user_id 6) 例：请求 返回

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 } ]

6

三. 错误代码对照表错误返回格式成功的话 'status':2007

{'respond': {'status': 500, 'code': 0, 'msg': 'success'} 错误的话 'status':500,'code'为错误代码 {'respond': {'status': 500, 'code': 10008, 'msg': '参数错误'}} {'respond': {'status': 500, 'code': 20101, 'msg': '暂时没有数据'}}

系统级错误代码错误代码 错误信息 详细描述

10001 10002 10003 10004 10005 10006 10007 10008 10009 10010 10011 10012 10013 10014 10016 10017 10018 10020 10021 10022 10023 10024

System error Service unavailable Remote service error IP limit Permission denied, need a high level appkey Source paramter (appkey) is missing Unsupport mediatype (%s) Param error, see doc for more info Too many pending tasks, system is busy Job expired RPC error Illegal request Invalid weibo user Insufficient app permissions Miss required parameter (%s) , see doc for more info

系统错误 服务暂停 远程服务错误 IP 限制不能请求该资源 该资源需要 appkey 拥有授权 缺少 source (appkey) 参数 不支持的 MediaType (%s) 参数错误，请参考 API 文档 任务过多，系统繁忙 任务超时 RPC 错误 非法请求 不合法用户 应用的接口访问权限受限 缺失必选参数 (%s),请参考 API 文档

Parameter (%s)'s value invalid, expect (%s) , but get 参数值非法，需为 (%s),实际 (%s) , see doc for more info 为 (%s),请参考 API 文档 Request body length over limit Request api not found HTTP method is not suported for this request IP requests out of rate limit User requests out of rate limit User requests for (%s) out of rate limit 请求长度超过限制 接口不存在 请求的 HTTP 方法不支持 IP 请求频次超过上限 用户请求频次超过上限 用户请求特殊接口 (%s) 频次 超过上限

服务级错误代码错误代码 错误信息 详细描述

20001 20101 20102

device os must be not null

手机的操作系统平台不能为空 暂时没有数据 签到过于频繁8

四. API 用例列表API 参数说明API 参数中 String 类型的参数可以=’’,等效于不传该参数。 API 参数中 Int 类型的参数可以=-1,等效于不传

该参数。

API 用例列表API 名称 基础信息接口获取影片信息 按照城市 id 获取影片列表 http://www.77cn.com.cn/lyk/v1/mobile/movie/info/2 http://www.77cn.com.cn/lyk/v1/mobile/movie/list/290

API 用例

活动接口

XX 接口

9

本文来源：https://www.bwwdw.com/article/jb3i.html