智墨桌牌管家 — 开发者接入

能做什么

查这个组织名下有哪些桌牌：什么屏、电量多少、此刻能不能远程刷
列出可用模板
把一位与会者的姓名 / 职务 / 单位刷到指定那台桌牌上
查这次下发到底成没成

一个前提请先看清楚：桌牌是蓝牙设备，云端够不着它。远程下发必须有你自己的会议室网关在场（一台安卓盒子或电视，插电联网即可）。没有网关的场合，请用小程序 + 手机蓝牙，人需要在现场。

三分钟跑通

联系我们开通接入凭据后：

export ZHIMO_PARTNER_ID=pk_xxxx
export ZHIMO_SECRET=sk_xxxx

python3 zhimo_cli.py devices                    # 我有哪几台牌、现在能不能远程发
python3 zhimo_cli.py templates 白梅              # 挑一款模板
python3 zhimo_cli.py send C2:7F:36:A5:11:E6 ct6g_bird1 张震 总裁 网梯科技

最后一条会等到真实结果再返回：

✓ 已刷到屏上 (jobId=1f18a504-1b9a-4cfb-a2b3-72b08bd0f0ae)

只有「已刷到屏上」才算成功。服务端把数据发出去不等于屏上画出来了 —— 弱信号、掉包、设备拒收都发生在那之后，所以最终状态由网关的真实回传决定。

用 Python 调

from zhimo_sdk import ZhimoClient, Attendee

c = ZhimoClient(partner_id, secret)

for d in c.list_devices():
    print(d["mac"], d["name"], "可远程发" if d["remoteDeployable"] else "网关不在场")

c.deploy("C2:7F:36:A5:11:E6", "ct6g_bird1",
         Attendee(name="张震", title="总裁", company="网梯科技"))

SDK 零第三方依赖，只用标准库；签名、重放保护、错误解包都在里面。

接口一览

接口	作用
`GET /api/partner/devices`	桌牌清单（含此刻能否远程下发）
`GET /api/partner/templates`	可用模板
`GET /api/partner/device/{mac}`	单台状态
`POST /api/partner/deploy`	提交一次下发，返回 jobId
`GET /api/partner/deploy/{jobId}`	查这次下发的结果

鉴权为 HMAC-SHA256 请求签名，带时间戳窗口与 Nonce 防重放，每个接入方独立配额。完整字段与签名规则见随包的 DESIGN.md 与 openapi.yaml。

做不到的事

写在前面，省得你按错误的假设去设计对接：

改模板版式（挪字、换配色、换底图）—— 请在小程序的编辑器里做，接口只能选现成模板
没有网关的会议室—— 只能用小程序 + 手机蓝牙
整份名单一次导入—— 接口一次一个人；整场会议排牌请用小程序的「批量下发」
读取桌牌当前显示的内容—— 不提供

怎么拿到凭据

接入凭据按组织开通，请联系：010-58731118。开通时请告诉我们贵司名称与用途，我们会把 partner_id 与 secret 以及配套的 SDK 包一并给到。

secret 只在开通时显示一次，请妥善保存；泄露可随时重置。