SuperAPI AI 工具集

seam-access-grants

通用与其它

查看项目

更新于 10-16 02:31

技能介绍

用途:在现有代码库中集成 Seam Access Grants,实现按门、按凭证的智能锁访问控制。创建授权时需指定用户身份、目标设备、请求的访问方式(PIN 码或移动钥匙)和时间窗口,Seam 会在锁上配置凭证。

主要能力:创建、更新、删除访问授权;支持一次授权多扇门(device_ids 为数组);支持 PIN 码(mode: code)和移动钥匙加 Instant Key(mode: mobile_key);通过 webhook 接收 access_code.set_on_device、access_code.failed_to_set_on_device、device.disconnected 等事件。

使用方式:安装 SDK(npm install seam / pip install seam / bundle add seam,不要固定版本)。Next.js 中在模块作用域 new Seam() 会破坏 next build,需用惰性 getter;Express/标准 Node.js 可直接实例化。每间房/每扇门必须映射到各自的 device_id,不可使用全局设备回退,映射缺失时应让操作失败。在预订创建函数中调用 seam.accessGrants.create,并保存 access_grant_id 到预订对象;预订变更时调用 update,取消时调用 delete。user_identity 使用 full_name 和 email_address。需将服务函数改为 async 并更新调用方 await。

适用场景:酒店客房、健身房等需要按房间或入口分配临时门禁的预订类应用。

限制:资料未提供收费、价格、平台支持范围等信息;失败模式需自行决定(必需访问则抛错,可选则记录并继续);access_grant_id 为空表示授权失败需重试。