钥
IDENTITY
身份与权限
统一企业身份源，支持 OAuth 2.0 / OIDC、应用授权、部门角色与操作审计。
CAPABILITIES
开放能力一览
按产品包开通，每个能力都提供沙箱、配额、审计与独立 SLA。
仓
DATA
数据交换
发布数据目录、字段级权限、拉取与事件订阅，支持脱敏与调用留痕。
流
WORKFLOW
流程编排
审批、派单、验收沉淀为可编排服务，支持表单回写与回调。
讯
MESSAGE
消息与回调
站内信、短信、邮件与签名 Webhook，支持失败重试与死信查询。
联
IOT
物联接入
设备档案、遥测入库与指令下发，适配园区与能源场景。
图
GEO
空间服务
地址标准化、围栏判断与基础图层查询。
ONBOARDING
五步完成接入
01
注册应用
提交企业资质，创建沙箱应用并获取 AppID。
02
开通能力
按业务勾选身份、数据或流程等产品包。
03
联调测试
在沙箱用模拟数据完成签名与回调验证。
04
安全评审
核对 IP 白名单、密钥轮换与等保要求。
05
生产上线
切换正式环境，纳入可用性与工单保障。
SOLUTIONS
行业解决方案
把能力组合成可落地的场景，以下为演示方案。
政务服务
一网协同与数据共享
统一身份登录政务门户，按目录交换证照与办件状态，流程承接跨部门审批。
能源电力
场站监测与工单闭环
物联采集遥测，越限触发工单，对外开放有限指令与状态查询。
医疗卫生
院内集成与区域协同
标准 API 对接预约、检验与消息，数据层处理脱敏指标共享。
产业园区
通行、能耗与空间一张图
空间服务管理楼宇与车位，物联覆盖门禁与能耗。
DOCS
开发文档
建议阅读顺序：快速开始 → 认证 → 第一次业务调用 → 错误码。
快速开始
1. 在申请区提交企业信息，开通沙箱应用。
2. 使用 client_credentials 换取 access_token。
3. 请求头携带 Authorization: Bearer <token> 调用业务接口。
4. 对照沙箱返回确认签名无误后，再申请生产权限。
认证鉴权
平台默认采用 OAuth 2.0 客户端模式。Token 默认有效期 7200 秒，禁止把密钥写入前端仓库。
签名规则
写操作及回调需 HMAC-SHA256 签名，参与字段：timestamp、nonce、method、path、规范化 body。时间窗 ±5 分钟。
常见错误码
| code | 含义 | 处理建议 |
|---|---|---|
| 0 | 成功 | — |
| 40101 | Token 无效或过期 | 重新获取令牌 |
| 40310 | 能力未开通 | 在控制台勾选产品包 |
| 42900 | 触发限流 | 退避重试 |
API
API 参考
以下为演示契约，正式环境请以 OpenAPI 规范为准。
获取访问令牌
POST /v1/oauth/token
| 字段 | 类型 | 说明 |
|---|---|---|
| app_id | string | 应用标识 |
| app_secret | string | 应用密钥 |
| grant_type | string | 固定 client_credentials |
查询部门列表
GET /v1/org/departments
发送站内消息
POST /v1/messages
可在下方 沙箱调试 中模拟调用。
SANDBOX
沙箱调试台
静态演示：请求在浏览器内模拟返回，不会访问真实网关。
选择接口后点击「模拟调用」。
SDK
SDK 与工具
Java
implementation "com.ztsy.open:sdk-java:1.4.0"
Python
pip install ztsy-open
Node.js
npm i @ztsy/open-sdk
Go
go get github.com/ztsy-open/sdk-go
PARTNERS
生态合作
面向 ISV、系统集成商与区域渠道。
产品共建
行业插件挂到能力目录，平台统一鉴权与计量。
联合交付
西南区域项目组合开放能力与现场实施。
培训认证
接口认证、沙箱实验与售后分级。
SUPPORT
支持中心
沙箱 Token 调不通？
确认使用沙箱域名、系统时间误差小于 5 分钟，且 App 已开通对应产品包。
回调收不到？
检查 HTTPS 证书、公网可达性与签名校验逻辑。
如何申请提额？
生产环境按合同配额执行，突发活动请提前联系客户成功经理。
UPDATES
平台动态
数据交换 API v1.4 发布
新增字段级脱敏策略与订阅积压查询接口。
沙箱环境扩容完成
联调并发提升，默认配额调整详见支持中心。
物联接入支持 MQTT 5.0
兼容存量 TCP 协议，迁移指南已更新。
ABOUT
四川众拓晟远信息科技
我们做什么
众拓晟远定位于政企数字化底座与生态开放：把身份、数据、流程、消息、物联和空间能力标准化，让合作伙伴少走一遍烟囱集成。
价值观
众力协同交付，拓界开放接口，晟光把复杂系统做清楚，致远对客户长期负责。
STATUS
服务状态
全部系统运行正常（静态示意）。
身份认证网关正常
数据交换总线正常
流程引擎正常
消息 / Webhook正常
物联接入正常
沙箱环境正常
APPLY
申请成为开发者
请准备营业执照、对公邮箱与预计调用量。审核通过后发放沙箱 AppID。
CONTACT
联系我们
商务与总机
电话：028-0000-0000（占位）
邮箱：open@ztsy.example
工作时间：工作日 09:00–18:00
办公地址
四川省成都市高新区（详细楼宇待补）。
LEGAL
法律条款
示范文本，正式上线前应由法务修订。
平台服务协议
本协议由四川众拓晟远信息科技有限公司与使用开放平台的企业用户订立。开发者通过申请接入或调用接口，即视为同意本协议。平台方提供文档所述开放接口、沙箱与配额内的调用与技术支持。
隐私政策
收集企业名称、统一社会信用代码、联系人信息用于入驻审核与服务交付。接口日志用于安全审计与故障定位，不会向无关第三方出售个人信息。隐私事务邮箱：privacy@ztsy.example。
开发者协议
开发者应保证应用合法、具备独立隐私政策，不得超范围使用平台数据。生产密钥须由企业管理员保管并定期轮换，发生泄露应立即报备并重置。