文档

BackResto 合作方 API,从头到尾。如果你已经拿到密钥,就从快速上手开始。

快速上手

合作方 API 是什么,以及如何发出第一个请求。

介绍

BackResto 合作方 API 今天开放了什么、有意不开放什么,以及由谁来决定。

获取密钥

如何申请一把合作方 API 密钥、申请里要写什么,以及会拿到什么。

快速上手

从一把密钥到你的第一批记录和一张收货照片,五分钟,用 curl 完成。

核心概念

认证、错误、分页与速率限制。

认证

合作方密钥、二十六个权限范围、一份授权意味着什么,以及如何在不停机的情况下轮换。

错误

每一次失败都返回同一种机器可读的 problem 文档,以及每种类型对你的重试逻辑意味着什么。

分页

如何用一个不透明游标走完任意一个集合,以及如何让一份副本保持最新。

速率限制

按密钥计算的请求额度、描述它的那唯一一个响应头,以及怎样稳稳地待在额度以内。

资源

各个接口,逐字段说明。

集合与记录

二十六种记录集合、它们共用的那个快照信封,以及如何走完一个集合。

温度

冷藏温度与加热温度,由人测得或由传感器上报:三个集合,以及区分它们的是什么。

追溯标签

员工打印出来贴在容器上的二次标签,附着被打印的那个文件,以及每一批打印各自的一个组标识符。

收货记录

收货查验和收货时拍下的照片:两个集合、每一个字段,以及它们在后厨现场意味着什么。

清洁

清洁计划、真正做过的那些任务,以及证明它做过的照片:三个集合,以及一条缺失的记录证明不了什么。

炸锅

那些炸锅和在它们上面做的油品质量检查:两个集合,以及为什么测得的值可以缺失、而那个决定绝不会。

冷却与食品处理流程

冷却、冷冻、复热与运输:记录一次温度转变的四个集合,以及一次没做完的转变长什么样。

表面采样

表面涂抹采样:测的是什么、是否通过,以及不通过时的那份行动计划。

文档

餐厅自己的文档库(证书、操作规程、报告),每条记录都是一份归档的文件,各有自己的媒体类型。

基础目录

供应商、产品与自制备料:记录的其余部分所指向的那几份参照清单。

场所与人员

这家门店、它的员工、它的区域和它的机器:每一次温度读数都挂在上面的那张固定地图。

智能体与 MCP

通过 MCP 把 BackResto 接入 AI 客户端。

MCP 服务器

用一个 URL 和你的 API 密钥,把 Claude、Cursor、Codex 或任何 MCP 客户端接到一家餐厅的合规记录上。

支持

版本管理、当前数据的局限,以及如何联系我们。

支持与数据完整性

当前的数据涵盖什么、不涵盖什么,API 如何做版本管理,以及怎样找到一个真人。