Developers

四小时,接通第一个集成

Your first integration, live in an afternoon.

2,400+ REST 端点,覆盖从生产工单到门店小票到营销活动的每一个业务对象。OAuth2 认证 · 全量 OpenAPI · 沙箱环境。

快速开始:四步接通

  • ① 注册开发者账号:在控制台创建应用,获得 client_id / client_secret(沙箱密钥即时发放)
  • ② OAuth2 取令牌:client_credentials 模式换取 access_token,有效期 3600 秒,支持刷新
  • ③ 调第一个接口:带上 Bearer Token 调商品查询,拿到你的第一个 200
  • ④ 上生产:切换生产密钥,配置回调域名白名单,完成应用审核

Webhook 与高敏感写操作额外使用 HMAC-SHA256 签名(时间戳 + 请求体),校验 ±300 秒时间窗防重放。

# 1) 获取 access_token
curl -X POST https://api.mrmeos.com/oauth/token
  -d '{"grant_type":"client_credentials",
       "client_id":"...","client_secret":"..."}'
# => { "access_token":"eyJ...", "expires_in":3600 }

# 2) 查询商品列表(Retail OS · 商品域)
curl https://api.mrmeos.com/v1/retail/products?page_size=20
  -H "Authorization: Bearer eyJ..."
  -H "Idempotency-Key: 9f3a1c2e"  # 写操作必带
# => { "data":[{"id":"prod_001","sku":"SKU-001"}],
#      "next_cursor":"eyJvZmZzZXQiOjIwfQ" }
今天下午,跑通第一个 200

文档板块

快速开始

从拿密钥到第一个 200 响应,四步走完。

API 参考

2,400+ 端点按产品线与业务域分组,OpenAPI 3.1 文件可整包下载。

Webhook 指南

订阅业务事件,验签防伪造,死信可重放。

增量同步

基于游标的变更拉取,不用全量轮询。

幂等键规范

网络重试不产生重复单据的正确姿势。

沙箱环境

带预置演示数据的隔离环境,随便折腾。

速率限额

各档位限额与超限行为,透明可查可规划。

错误码表

统一错误结构与全量错误码检索。

SDK 计划

官方 SDK 路线图与社区库。

API 能力域

三大 OS 的业务对象与状态机均可寻址。

Retail 域

商品 · 订单 · 库存 · 会员 · 价格本 · 门店 · 财务凭证

Factory 域

工单 · BOM · 排程 · 报工 · 质检 · 批次追溯 · ASN

Marketing 域

文章 · 页面 · PIM · SEO 任务 · GEO 探针 · 询盘 · 社媒

平台域

租户 · 权限 · Webhook · 审计 · 事件重放

Go Deeper

相关页面

读规范,进沙箱,
今天发出第一个请求。

沙箱免费 · OpenAPI 规范公开下载 · 速率限额透明