开发者文档

如果你要让自己的系统读取门店订单，从第一次 REST 请求开始。如果你只想让门店在订单付清时执行一个动作，不需要搭建服务，直接看高级自动化文档。

选择接入方式

想实现的功能	接入方式	身份与边界
后端定时读取有权访问的门店或组织	门店与组织 REST API	个人 API 令牌；同时受令牌范围和本人当前权限限制
让 AI 助手查订单，或只开放几项门店操作	门店 MCP	一个外部令牌对应一家店和一组工具
给门店托管活动介绍页或自建前端	网站托管	上传静态产物；草稿预览和正式发布是两步
在小程序打开的网页里抽奖、领券或保存进度	活动网页 SDK	顾客票据只对当前活动生效；奖励由服务端决定
在自己的服务端对独立 SQLite 库执行 SQL	云数据库	单库令牌；可设为只读，不能查询 Foodiy 业务库
扩展收银端、门店屏或开发顾客屏主题	终端、设备与主题 SDK	按宿主协议、声明的能力和签名加载

从一次只读操作开始

先在工作台确认当前门店、权限和模块，再为调用方选择最小范围。用读取一页订单、列出工具或执行 SELECT 1 核对身份和响应，再接入业务逻辑。商家令牌和单库令牌留在服务端；顾客网页使用自己的 SDK 和活动票据。