开发者文档

完整开放平台：门铃号登录、授权码换门牌、用户/店铺/商品只读。App 专用接口仍是 api.menkou.com，到口客服仍是 iai.menling.com。

1. 接入流程
2. 网页授权
3. 换门牌
4. 用户 / 店铺 / 商品
5. 扫码与唤醒 App
6. 错误码
7. 安全

1. 接入流程

1. 门铃号登录 https://open.menkou.com/login
2. 控制台创建应用，登记 https 回调，保存 App Key / Secret
3. 用户浏览器跳转授权，或展示二维码用到门口 App 扫
4. 服务端 POST /oauth/menpai 换门牌
5. 带门牌调用 /oauth/userinfo /shop /goods

2. 网页授权

GET https://open.menkou.com/oauth/authorize
  ?app_key=应用Key
  &redirect_uri=已登记回调
  &state=随机串
  &response_type=code

成功回调：redirect_uri?code=授权码&state=原样
拒绝：redirect_uri?error=access_denied&state=原样

授权页会说明：只提供门铃号，不提供密码、手机和资金。

3. 换门牌（必须服务端）

POST https://open.menkou.com/oauth/menpai
Content-Type: application/x-www-form-urlencoded

app_key=Key&app_secret=Secret&code=授权码&redirect_uri=与授权时相同

成功：
{"code":1,"menpai":"...","menpai_type":"Menpai","expires_in":7200,"uid":1}

别名：POST /oauth/token 同样。

4. 用户 / 店铺 / 商品

GET https://open.menkou.com/oauth/userinfo?menpai=
Header 也可：Authorization: Menpai 门牌值
返回 uid、doorbell、name（无手机、无资金）

GET https://open.menkou.com/oauth/shop?menpai=
店铺名、地址、logo、域名

GET https://open.menkou.com/oauth/goods?menpai=
该用户店铺下商品名、价格、图（最多 20）

GET https://open.menkou.com/oauth/product?id=商品ID
公开只读商品详情（图、价、店铺名）

GET https://open.menkou.com/oauth/ping
探活

5. 扫码与唤醒 App

GET https://open.menkou.com/oauth/qr?app_key=&redirect_uri=&state=
返回 ticket、img、scan、poll、wake_ios、wake_android

GET https://open.menkou.com/oauth/poll?app_key=&ticket=
status 0等待 1已扫 2已确认(含 code) 4过期

GET https://open.menkou.com/oauth/wake?t=ticket
iOS ydmkshop://oauth?t=
安卓 dmk://oauth?t=

6. 错误码

HTTP 400  参数 / 应用 / 回调 / 授权码
HTTP 401  门牌无效或过期
HTTP 404  商品不存在
JSON code=0 时看 msg

7. 安全

• App Secret 只放对方服务器，禁止写进网页、App 包、Git 公开仓。
• redirect_uri 必须事先登记，且与换门牌时完全一致。
• 门牌有过期时间，过期重新走授权。
• 开放平台不返回手机号、密码、余额。

开发者登录 · 代码仓