WanLink 万厘连New 开发文档WANLINK NEW · 开放状态

WANLINK NEW / DEVELOPER DOCUMENTATION

构建边界清晰的
企业应用集成

这里说明 WanLink New 当前的公开展示、接入边界与开放状态。产品介绍中的能力规划不等于已经发布可供外部应用调用的接口。

本文不公开平台内部结构、运维目录、凭据或错误定义全集。

PLATFORM CAPABILITY OVERVIEW

平台能力与产品边界

IDENTITY

平台登录

平台管理身份与企业员工身份分离。现有管理账号从统一登录入口进入相应工作台;普通员工不登录管理平台,员工应用登录属于企业应用。

ORGANIZATION

组织与人员

同一企业的多个应用共享组织与人员主数据、在职事实。企业管理员组织及人员基础管理已开放;M7已开放真实AppToken保护的企业共享组织及人员接口,范围和版本以New当前合同为准。

开放状态组织、人员管理及AppToken API可用
PERMISSION

岗位、角色与权限

按企业与应用精确隔离。身份有效后直接读取员工最终权限结果;不通过名称或字符串前缀自动跨应用授予权限。岗位与任职管理及对应 AppToken API 已开放,支持同应用调岗与历史;角色、权限引擎及其 API 尚未实现。

开放状态岗位任职已开放,角色权限待实现
APPLICATION

企业应用与可信接入

企业应用拥有自己的业务页面、数据及文件。AppToken 接入使用服务端确认的企业应用范围,不接受调用者任意变更企业身份;机器凭据签发及员工认证按当前合同调用。

开放状态应用接入已开放
WORKFLOW

审批与文件

平台负责审批模板及模板投影;审批执行、业务实例与审批附件归企业应用。平台文件仅服务平台自身业务。M11 已提供本应用模板下载、有效人员投影和同步回执;业务审批执行产品与平台文件能力另行交付。

职责边界不迁入旧平台业务实现
ONBOARDING

企业入驻

企业通过首页五字段弹窗自主注册,手机号作为首管理员账号;企业和首管理员一致开通后进入平台登录。已登录管理账号不能代建企业,注册密码不保存为浏览器草稿。

INTEGRATION BOUNDARIES

接入约定

一个当前运行模型

New 只服务当前有效领域模型,不并行提供旧平台业务版本。环境差异由部署层处理,候选部署尚未完成。

以正式开放合同接入

应用身份、员工范围和权限必须由正式合同确认。尚未开放的业务不提供模拟成功、旧站代理或猜测的端点。

平台与应用的数据范围

组织人员按企业共享;岗位、角色、权限及授权来源按企业和应用隔离。订单、库存、审批执行和业务附件由应用维护。

CURRENT PUBLIC SURFACE

公开页面与开放状态

本栏是公开展示及部署诊断说明,不是企业应用业务 API 的发布清单。

GET公开页面匿名可浏览

首页、平台介绍、开发成本测算、价格方案、本文及留言展示均为 New 独立页面。公开内容不授予平台管理权限。

首页 · 平台介绍 · 开发账本 · 价格方案 · 留言箱

注册与留言注册与留言已开放

注册弹窗填写企业名称、姓名、手机号、密码和确认,成功后进入已有登录页。管理员只访问本企业;root与管理员均可在账户区修改本人密码,成功后需要重新登录。官网留言可填写姓名、电话、可选企业和邮箱、四类事项及正文;可选择最多3个附件,每件不超过10MiB。真实提交成功返回留言编号,资料仅平台管理员查看。附件限JPG、PNG、PDF、DOC、DOCX、ZIP,源码下载仍未开放。

企业应用 APIM9 R1当前接入已开放

企业管理员在应用中心注册最多五个应用,启用与停用合计。当前连接资料可重复下载,下载不轮换;独立重置后旧应用密码及Token失效。

应用后端以app_id/app_password请求 POST /api/app/token,持Bearer AppToken调用 GET /api/app/me。当前企业和应用来自实际验证,不能由请求覆盖。

/api/app/organizations 和 /api/app/personnel 开放企业共享查询、创建、维护、排序及停用,人员含恢复。复用正式版本、根保护、唯一和真实组织占用;人员新增operation_id幂等,initial_password仅首次成功响应,重放不可重取。遗失须WanLink本企业管理员明确重置。

POST /api/app/employees/authenticate、/validate、/password 为员工认证、当前资格检查和本人原密码改密。应用服务端从自己的真实会话取得员工ID/代次,每次受保护请求同步检查;旧会话在员工改密后失效,AppToken独立。员工不能登录管理平台。

新人类密码8至1024个Unicode码点,ASCII数字、英文大写、英文小写、ASCII标点四类至少两类;旧有效密码按已存哈希登录。岗位与任职接口已在 M8 开放。M9 提供真实最终权限查询;M11 已接通审批模板与人员投影同步,正式 New 标准应用已提供客户、目录、审批执行与消息通知界面;不提供默认全权限。

M9 R1:企业管理员在应用权限页创建定义,在应用角色页维护人员、岗位、组织来源及角色权限;组织来源固定覆盖有效下级与本应用岗位任职人员。应用后端仅 GET /api/app/permissions 查询目录,PATCH /api/app/permissions/metadata 更新已注册的 page_name、property、description(带 version),未知项整批拒绝,不提供创建、upsert、启停或角色授权写入口。

应用内 code 为 1..256 位 ASCII,字母统一小写,非空点分段无继承。POST /api/app/authorization/check 接收 employee_id、code;POST /api/app/authorization/batch 接收 employee_id、codes(1..500项),返回 items 中逐项 ALLOW、DENY、UNREGISTERED,保持输入顺序及重复项。停用定义为 DENY,当前应用未知定义为 UNREGISTERED;身份、参数、范围和存储错误是带具体 code/request_id 的请求失败。

GET /api/app/employees/{employee_id}/permissions 返回全部实际有效权限,空集合不允许业务操作。员工目标须取自应用服务器的有效员工会话,先按既有 /validate 合同核验代次;一次批量鉴权只读最终权限,不展开角色/岗位,也不缓存允许结果。来源撤销或角色停用提交后,同一有效员工会话的新鉴权立即改变。范围来自真实 AppToken,不能传入另一企业或应用覆盖。

GET基础健康检查部署诊断

/health/live 表示当前进程可以处理请求;/health/ready 只验证基础数据库依赖,成功返回 200,未配置或失败返回 503。它们不能证明业务、授权或企业接入已经可用,也不返回连接信息。

SDK 与标准应用文档

按身份和开发方式阅读 M21 文档。当前发行候选状态以随包验收回执为准。

文档目录 · 企业管理员手册 · 标准应用安装 · SDK 接入教程