# 美团企业版H5免登接口
# 1 【快速接入】
# 1.1 接入说明
企业通过H5免登方式使用美团企业版服务(不支持iframe方式接入),整体接入流程如下
- 通过项目经理在美团企业版创建企业
- 美团企业版提供免登相关
appKey
、公钥
、私钥
# 1.2 免登接口签名示例
补全签名示例 中com.meituan.sqt.h5Access.SqtH5Access.main的参数并调用,生成最终url
# 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三者必填一个 与企业员工唯一识别对应 |
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时必传;{"policyKey":"1"} policyKey为小象供给管控规则匹配参数,productType为mt_maicai时可传 |
注:当请求字段值为json格式时:
拼接在url后的参数必须encode,用于生成signature时不需encode。
# 业务请求响应
目标产品页(如果当前用户首次进入,会进入手机号绑定界面)