各企业的小程序、公众号、官网、收银系统,统一通过乡服通 API 接入。平台是总信息口:资源在这里汇聚,权限在这里发放,交易在这里闭环。
① 申请应用 → 获得 app_key / app_secret
② 服务端签名鉴权,换取 access_token
③ 按接口文档对接:用户、商品、订单、积分、结算
④ 沙箱联调通过后切换生产环境
登录后可申请;secret 仅显示一次,请立即保存。
| 方法 | 路径 | 说明 |
|---|---|---|
| POST | /api/index.php?r=auth/send-code | 发送登录验证码 |
| POST | /api/index.php?r=auth/login | 手机号 + 验证码登录,返回 token(7 天有效) |
| GET | /api/index.php?r=me | 会员信息 / 订单 / 积分流水 |
| GET | /api/index.php?r=services | 服务列表,支持 category 过滤 |
| POST | /api/index.php?r=orders | 下单(扣 Token、返积分,事务保证) |
| POST | /api/index.php?r=token/recharge | 算力 Token 充值(生产接支付回调) |
| POST | /api/index.php?r=open/apply | 申请应用凭证 |
| GET | /api/index.php?r=admin/stats | 治理中心统计(管理员) |
| GET | /api/index.php?r=admin/approvals | 审批单列表(管理员) |
Authorization: Bearer <token>;开放平台应用另需 X-App-Key + HMAC-SHA256 签名(用 app_secret 对 时间戳+请求体 签名),防止重放。
企业自有小程序保留原有界面,登录、商品、订单、核销对接平台接口,会员体系统一。
微信授权登录换取 unionid,老网站不动前端,只替换数据源。
社保、医保、补贴类接口预留独立命名空间,按部门白名单开放,不与商业数据混用。