格物 开放 API概览
Docs
开放 API 文档
先看接入场景确认你的应用属于哪一种（与申请正式接入时选的一致），再选择接入方式：自己调 REST 接口，或让 AI Agent 通过 MCP 调用。 接口地址 https://api.gowu.net，MCP 地址 https://api.gowu.net/mcp；给 Agent 读的索引见 llms.txt。
从这里开始
接入场景
申请正式接入时选的「你的用户是谁」就是这里的场景，审批通过后按场景开通对应的接口权限。员工福利购物与企业采购用同一套企业额度 （可全额用额度，也可由员工自己付现金：支付宝 / 微信 / 对公），区别只在福豆任务、签到等福利玩法和界面叫法；消费者购物由用户在线支付。 左侧导航可以只看某一个场景的内容。
场景 1 员工福利购物给自己公司搭员工福利应用（类福利GO）：企业把福利额度（福豆）发给员工，员工用额度选购，差额可用支付宝补；还有福豆任务、签到、生日福利等激励玩法。 | 场景 2 企业采购给自己公司搭采购应用：企业把采购额度发给采购人员，按部门做预算，员工用企业额度下单，超出部分可用支付宝补；企业统一结算开票。 | 场景 3 消费者购物面向普通消费者：你传每个用户自己的 open-id，用户在浏览器里用支付宝付给平台，平台自动下单。适合消费者商城、导购与内容电商、AI 购物助手。 | |
|---|---|---|---|
| 交易模式 | 企业额度，可全额或混合支付 | 企业额度，可全额或混合支付 | 用户在线支付 |
| 典型应用 | Skill 与工具插件、企业福利商城 | Skill 与工具插件、员工采购与办公集采 | AI 购物助手（Agent）、Skill 与工具插件、消费者小程序与网站商城、订阅与周期购、导购与内容电商 |
| 终端用户 | 本公司员工 | 本公司采购人员 | 任何个人用户 |
| 接入前提 | 在控制台申请正式接入并录入企业信息，经平台审核开通 | 在控制台申请正式接入并录入企业信息，经平台审核开通 | 登录控制台即有体验 appKey；正式接入经平台审核开通 |
| x-open-user | 员工的用户 ID，必须先绑定到企业才能下单 | 员工的用户 ID，必须先绑定到企业才能下单 | 每个用户自己的 open-id，直接传，首次访问自动建档 |
| 钱怎么走 | 企业预充值或授信；员工用额度下单，可全额用额度，也可企业承担一部分、员工支付宝补差；企业按账单结算 | 与员工福利同一套企业额度（界面叫企业额度，接口字段仍是 points）；可全额用额度或混合支付 | 用户用支付宝付给平台，平台自动下单、失败自动退款 |
| 收货地址 | 省、市、区名称（用区划接口取规范名称） | 省、市、区名称（用区划接口取规范名称） | 行政区划码（先查区划接口） |
| 发票 | 下单后自动开票，抬头取企业信息 | 下单后自动开票，抬头取企业信息 | 暂不提供接口开票 |
| 特有接口 | 员工绑定、额度发放、账单、福豆任务、签到、生日 | 员工绑定、额度发放、部门预算、账单与消费统计 | 平台收银台（支付链接、托管结账页）、MCP |
| 开始接入 |
选择接入方式
同一套能力、同一套业务规则，两种接法：自己调 REST 接口，或让 AI Agent 通过 MCP 调用。同一个 appKey 两种方式可以同时用。
| REST API | MCP | |
|---|---|---|
| 适合 | 你自己的 App、小程序、网站后端 | AI Agent：你的 Agent 后端，或 Claude、Cursor 等客户端 |
| 地址 | https://api.gowu.net/v1/… | https://api.gowu.net/mcp |
| 凭证 | appKey + app_secret | MCP Token（平台签发，对应你的 appKey） |
| 签名 | 你的服务端为每个请求计算 HMAC-SHA256 | 不需要，平台在服务端以你的 appKey 完成 |
| 终端用户 | 每个请求的 x-open-user 头 | 连接上的 x-open-user 头（每个用户一条连接） |
| 覆盖 | 员工福利购物、企业采购、消费者购物 | 消费者购物（平台收款）；员工福利与企业采购后续开放 |
| 权限与限流 | 按 appKey 授权的接口 | 同一个 appKey：工具按已授权接口自动筛选，额度共用 |