Skip to content

权限项与后台菜单入口 ​

应用里“谁能进、谁能点哪个按钮”可以交给 Betly 的角色来管:场馆管理员在熟悉的权限分配页里勾选即可,应用不用自己维护一套权限。

权限项 ​

每个应用有一组权限项,编码格式是 app.<标识>.<后缀>:

权限项来源作用
app.<标识>.access登记应用时自动创建,名称为“进入应用”员工能否登录应用;没有它,员工在 Betly 授权页就会被拒
app.<标识>.<后缀>管理员在【权限项】页添加应用自定义的按钮或操作,例如 app.apply.approve 审核申请单

后缀只能用小写字母、数字、下划线和连字符。新增权限项的入口:应用详情 →【权限项】,填写【权限码】(后缀)与【名称】。

管理员在【设置】→【商户与权限】→【权限分配】里,把这些权限项勾给对应角色。

按钮级判权 ​

应用需要判断“当前员工能不能点审核”时,用应用凭证调用判权接口(需要 permissions:check 权限范围):

http
GET /api/v1/permissions/check?user_id=<员工 sub>&code=app.apply.approve HTTP/1.1
Host: api.mx5.cn
Authorization: Bearer bt_xxxxxxxxxxxxxxxxxxxxxxxx
json
{ "allowed": true, "store_ids": null }
{ "allowed": false, "reason": "missing_permission" }
  • user_id 是 /api/v1/me 返回的员工 sub;省略 code 时判断“进入应用”。
  • 只能查询本应用自己的权限项,查询其他编码返回 400。
  • store_ids 是员工角色绑定的门店,null 表示不限门店;应用按门店展示数据时可以参考。
  • reason 取值:app_not_authorized 应用未授权、not_in_org 不是本组织员工、not_active_staff 已离职、missing_permission 没有该权限项。
  • 判权结果会随角色调整实时变化。可以短时间缓存,但执行写操作前请再判一次。
  • 这个接口只接受应用凭证。会员没有权限项,会员能做什么由应用自己决定。

后台菜单入口 ​

把应用挂到 Betly 后台侧栏,员工在后台点一下就能进入应用。入口:应用详情 →【菜单入口】,填写:

字段说明
菜单名称侧栏显示的名字
挂载分组放在侧栏哪个分组下
应用内路径点击后打开的应用页面,相对应用地址,例如 /staff
绑定权限项有这个权限项的员工才看得到这个菜单

员工点击菜单后,Betly 先判断权限,再在新标签页打开“应用地址 + 应用内路径”。链接里不带任何凭证或身份,应用需要自己识别是谁:

  • 把应用内路径指向一个需要登录的页面;
  • 该页面发现没有登录时,自动按 员工与会员登录 发起员工登录;
  • 员工已经登录 Betly 后台,整个过程不用再输入密码,几秒内就带着员工身份回到这个页面。

不要在应用内路径里放令牌或员工编号,也不要相信链接参数里传来的身份。

相关操作 ​