# 美团企业版H5免登接口

# 1 【快速接入】

# 1.1 接入说明

企业通过H5免登方式使用美团企业版服务(不支持iframe方式接入),整体接入流程如下

  1. 通过项目经理在美团企业版创建企业
  2. 美团企业版提供免登相关appKey公钥私钥

# 1.2 免登接口签名示例

补全签名示例 中com.meituan.sqt.h5Access.SqtH5Access.main的参数并调用,生成最终url

签名示例demo下载

# 2 【业务接口】

# 免登接口

# 接口说明

名称 描述
功能 企业通过免登接口首次进行账号绑定后,以后无需登录直接可以访问产品页
说明 用户发起请求,请求中的人员需已添加在美团企业版,参数A-Z排序,SHA1WITHRSA签名
HTTP方法 GET
请求方 企业
响应方 美团企业版平台
url https://m-sqt.meituan.com/open/commonaccess/access

# 业务请求参数

名称 类型 是否必填 示例 说明
productType String 包括但不限于
dp_canyin(餐饮)
mt_waimai(外卖)
sqt_center(工作台)
sqt_info(我的)
sqt_home(美团企业版首页)
mt_hotel(酒店)
mt_maoyan(猫眼)
mt_car(美团打车)
sqt_food(用餐)
mt_maicai(美团买菜)
sqt_peican(配餐)
sqt_order_detail(订单详情)
repay_order_detail(偿还单详情)
order_list(订单列表)
audit_detail(审批详情)
mt_maiyao(美团买药)

以下只支持ToB企业
mt_train(火车票)
mt_plane(飞机票)
产品类型
用用于区分产品渠道
nounce String uqncknp89s8wh3gf 每次请求生成36位由字母数字组成的
随机字符串
appKey String zzyes appid 美团企业版提供
requestTime long 20170915165518 当前请求时间年月日时分秒
signature String K0dydeUudIApueQn... SHA1withRSA加密结果,需用
URLEncoder.encode(signature,"utf-8")处理后参与请求
entId int 2789 固定值,美团企业版提供
staffNo String 123123DFSAS23 staffNo、staffPhoneNo、email三者必填一个
与企业员工唯一识别对应
staffPhoneNo String 18842600000 staffNo、staffPhoneNo、email三者必填一个
与企业员工唯一识别对应
email String zhangsan@company.com staffNo、staffPhoneNo、email三者必填一个
与企业员工唯一识别对应
staffName String 张三 员工名称 非必填
主要在自动添加员工时使用
entToken String asdf46 企业登录态token,
用于验证企业用户登录态是否有效
targetUrl String 12345 重定向到目标产品页 需encode
(用于生成signature时不需encode)
thirdOrderId String 1234dd5 预订下单的时候需要记录
对应的第三方订单号
channelType int 1 频道类型
0--餐饮列表
1--团购列表
2--特许餐饮列表
longitude String 116.480881 经度
latitude String 39.989410 纬度
geotype String gcj02(火星坐标系)
或者wgs84(国际坐标系)
火星坐标系或者国际坐标系
(与经纬度一起用来定位)
address String 北京市朝阳区阜通东大街6号 经纬度对应的中文地址
wmExtraJson String {
"addressUserName":"姓名",
"addressPhone":"手机号",
"addressGender":1,
"addressHouseNumber":"门牌号",
"policyKey":"1"}
注:
1.内容为json字符串,
2.拼接在url后的参数必须encode,
3.用于生成signature时不需encode。
4.addressGender值 1-先生 2-女士,默认不传入则为先生
5.policyKey值为多入口模式下的供给规则对应参数,与供给规则中填写的值一致即可匹配
sceneType int 1 场景类型。
(1-商务宴请;2-企业用车;
3-商务差旅;4-工作餐;5-团建用餐;8-员工福利;9-供给分销)
budgetKey String 12345 第三方预算key,
需要接入企业自有预算 时必传
restaurantType Integer 1 选择餐厅类型: 1表示跳转筛选页面,2表示跳转到详情页面
restaurantId Long 12345 选择餐厅业务id:
美团企业版推送的id值(点确认选择提交时)
activityRuleId String 12345 活动规则id
lockCityType Integer 1 1--控制只能查询当前城市中的餐厅信息,
当productType=dp_canyin时有效
deptExtraJson String {"departmentName":"部门名称",
"departmentCode":"部门唯一标识"}
departmentName为部门名称(不允许有'-'符号),departmentCode为部门唯一标识
invoiceExtraJson String {"invoiceTitle":"发票抬头",
"taxNum":"税号"}
invoiceTitle为发票抬头,taxNum为税号
tmcTripExtraJson String {"tripId":1,
"outTripId":"outTripId",
"itineraryId":1,
"outItineraryId":"outItineraryId"}
差旅出差申请扩展json,有值就填入。
字段如下:
美团申请单ID tripId 类型为Long,
企业申请单ID outTripId 类型为String,
美团行程ID itineraryId 类型为Long,
企业行程ID outItineraryId 类型为String
repastApplyExtraJson String {"repastApplyNo":"repastApplyNo",
"outRepastApplyNo":"outRepastApplyNo"}
用餐申请扩展json,有值就填入。
字段如下:
美团用餐申请单号
repastApplyNo 类型为String,
企业用餐申请单号
outRepastApplyNo 类型为String。
ssoUser String {"id":"1","name":"a"} 对接第三方收银台透传用户额外信息时使用,会在调用第三方下单时通过extInfoMap字段
透传给企业
sqtOrderId String - 美团企业版订单ID,跳转订单详情或者偿还单详情时必传,与productType=sqt_order_detail或者repay_order_detail搭配使用
poiDetailJson String {"mtPoiId":"165548321","ruleId":-1} 门店详情信息,json结构,跳转门店详情时必传(productType需传dp_canyin),整体方案可咨询客户经理
extraParams String {"workplaceId":"1"} 扩展字段,数据结构kv形式,例如:{"workplaceId":"1","processInstanceId":"123"},workplaceId为职场ID,processInstanceId为审批实例id,product_type为audit_detail时必传

注:当请求字段值为json格式时:
拼接在url后的参数必须encode,用于生成signature时不需encode。

# 业务请求响应

目标产品页(如果当前用户首次进入,会进入手机号绑定界面)

上次更新: 4/22/2024, 4:15:08 PM