教程一:已有应用通过独立 SDK 接入
先创建新目录与Python3.12虚拟环境,不导入任何wsea或wanlink平台模块:
& '<Python3.12完整路径>' -m venv .venv
.\.venv\Scripts\python.exe -m pip install --find-links <发行wheelhouse> <SDK-wheel>
从同版 SDK 源码分发包 .tar.gz 解压 examples 目录到当前工作目录;wheel 负责安装库,示例文件随源码分发包提供。复制 examples/config.example.json 到不入库的 config.local.json,填自己的平台URL、app_id、app_password、enterprise_id、专用员工手机号/密码。企业管理员已注册所需权限并通过角色授予;SDK不能代做管理员授权。示例不保存用户密码到业务数据库。
.\.venv\Scripts\python.exe examples/quickstart.py --config config.local.json --output result.json
完整可运行代码见 examples/quickstart.py。顺序:context确认应用→authenticate得到可信EmployeeProof→check_permission单项→authorize批量三态→directory.frozen固定快照→download_changes只下载→approvals.catalog/download→resolve带实际发起人。输出仅安全统计,不输出AppToken/密码/发起证明。result已存在拒绝覆盖,换新输出路径。
接入业务时把 SDK 调用放在服务器,不放浏览器。认证成功不等于有业务权限;每个受保护操作应 validate_employee 并查当前完整权限。批量菜单一次authorize,结果保持输入顺序和重复项,UNREGISTERED要提示管理员登记。独立业务库事务由你的应用负责。
从通知到回执的可运行示例
examples/notification_consumer.py 用标准库SQLite作为示例自己的收件存储,不是为标准应用增加数据库方案。另建专用演示应用,设置独立接收地址。配置结构包含 platform(ClientConfig字段)、callback_bearer、instance_id。Bearer来自该应用正式接收凭据下载。
.\.venv\Scripts\python.exe examples/notification_consumer.py --config receiver.local.json --database inbox.sqlite --port 18330
.\.venv\Scripts\python.exe examples/notification_consumer.py --config receiver.local.json --database inbox.sqlite --once
第一进程验签/范围→耐久接收;第二命令下载平台投影→事务提交projection与RECEIPT_PENDING→提交applied→标记APPLIED。测试通知只TEST;无业务applied。重复event_id内容冲突拒绝;乱序不降修订,同版本定义或同修订绑定冲突拒绝。回执失败保留待回执,再次--once重试同receipt_id;不重复执行企业业务。平台receiver要能真正到达/notifications;公网回调需自己的HTTPS或批准通道。
示例没有完整审批引擎、管理后台或生产调度承诺。要开发业务使用下一教程;禁止用本地组织角色重新算审批人员,姓名映射只将employee_ids映射为展示姓名。