开放平台 · OPEN API

接入一次,长期互通

各企业的小程序、公众号、官网、收银系统,统一通过乡服通 API 接入。平台是总信息口:资源在这里汇聚,权限在这里发放,交易在这里闭环。

接入流程

四步上线

① 申请应用 → 获得 app_key / app_secret
② 服务端签名鉴权,换取 access_token
③ 按接口文档对接:用户、商品、订单、积分、结算
④ 沙箱联调通过后切换生产环境

平台统一鉴权与配额:每个应用独立调用额度,超额降级不中断;所有调用留痕,供商协会监管核查。
申请接入

生成应用凭证

登录后可申请;secret 仅显示一次,请立即保存。

接口清单

核心接口(v1)

方法路径说明
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,老网站不动前端,只替换数据源。

政务预留

社保、医保、补贴类接口预留独立命名空间,按部门白名单开放,不与商业数据混用。