餐厅智能平台 - 面向AI餐厅经济的API

The API Suite

五大API。一个智能层。

每个API只需一组凭证。无需餐厅遗留系统，无需数据迁移——只有结构化、可计算的餐厅智能。

Core API

餐厅知识 API

关于餐厅、菜单和用餐者的结构化知识——随时供任何AI模型或应用使用。

餐厅资料、营业时间和门店位置
带结构化属性的菜品
客户细分与偏好信号

GET/v1/restaurants/{id}

GET/v1/restaurants/search

GET/v1/restaurants/{id}/menu

GET/v1/customers/segments

// Fetch a restaurant with full menu intelligence
const res = await fetch('https://api.clawpos.com/v1/restaurants/1234?include=menu', {
  headers: { 'Authorization': 'Bearer YOUR_KEY' }
});
const 数据 = await res.json();
// 数据.menu[0].食材 → structured food graph

Semantic API

菜单智能 API

理解全球菜单中的每一道菜、每一种食材和每一个价格——语义化理解，而非纯文本。

菜品分类与菜系检测
食材提取与替代
价格智能与利润率估算

POST/v1/menu/parse

GET/v1/menu/{id}/菜品

GET/v1/菜品/{id}/食材

GET/v1/menu/价格-intelligence

// Parse an unstructured menu into intelligence
const parsed = await fetch('https://api.clawpos.com/v1/menu/parse', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ raw_menu_text })
});
// Returns 菜品 with 菜系, 食材, 过敏原

图谱 API

食物图谱 API

查询食物知识图谱——菜系、食材、营养和偏好——作为活的关系层。

图谱遍历与关系查询
营养与饮食属性查询
替代与搭配推荐

GET/v1/graph/nodes/{类型}

GET/v1/graph/edges/{from}/{to}

POST/v1/graph/traverse

GET/v1/食材/{id}/nutrition

分析 API

将原始运营数据转化为预测、绩效信号和可执行的商业洞察。

销售预测与需求预测
菜单表现与利润率分析
异常检测与告警

GET/v1/analytics/sales/预测

GET/v1/analytics/menu/performance

POST/v1/analytics/anomalies

GET/v1/analytics/reports

代理 API

在已经理解您业务的智能层上构建和部署餐厅AI员工——无需提示工程。

预构建智能体角色（COO、营销、分析）
带餐厅上下文的自定义智能体创建
工具使用与行动执行框架

POST/v1/agents/create

POST/v1/agents/{id}/chat

GET/v1/agents/{id}/tasks

POST/v1/agents/{id}/execute

// Deploy a Claw 经理 AI employee
const agent = await fetch('https://api.clawpos.com/v1/agents/create', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer YOUR_KEY' },
  body: JSON.stringify({ persona: 'claw-manager', 餐厅 ID: '1234' })
});
// Agent monitors 收入, generates reports, recommends actions

Built For

Who Uses the Intelligence 平台

从AI初创公司到企业级POS——一个层驱动整个餐厅AI生态系统。

AI 公司为智能体提供餐厅就绪智能

POS 平台s为现有系统添加智能

餐厅 SaaS可组合智能，而非另一个孤岛

食品技术赋能外卖、云厨房及更多场景

开发者体验

为快速交付的开发者而构建。

RESTful API、类型化SDK、交互式文档和沙箱环境。从第一次调用到生产环境，一个下午即可完成。

身份认证

带范围权限的API密钥。从开发者仪表板轮换、撤销和监控每个密钥。

Bearer令牌认证——一个密钥，所有API
范围密钥（只读、按API、按环境）
一键轮换，带优雅重叠期

API Keys OAuth 2.0 Webhook Signing

SDK与库

您团队已使用语言的第一方、类型安全SDK。从OpenAPI规范自动生成。

内置分页请求、重试和退避
完整TypeScript类型和Python数据类
Go、Rust、PHP和Ruby社区SDK

TypeScript Python Node.js Java Go cURL

# 查询食物图谱获取食材替代方案
curl -X POST https://api.clawpos.com/v1/graph/traverse \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"node": "ingredient:mozzarella", "relation": "substitute", "depth": 2}'

API规范

生产级、版本化且稳定。

每个端点遵循相同的约定。可预测的分页、一致的错误格式，以及永不破坏您集成的版本控制。

约定	规范	详情
基础URL	`https://api.clawpos.com/v1`	所有请求通过HTTPS。需要TLS 1.2+。
版本控制	URL路径版本化（`/v1`）	新版本以`/v2`发布；v2发布后v1维护24个月。
数据格式	JSON（请求和响应）	`Content-Type: application/json`。UTF-8编码。
身份认证	请求头中的Bearer令牌	`Authorization: Bearer YOUR_API_KEY`
分页	基于游标	`?limit=50&cursor=...`。当有更多数据时响应包含`next_cursor`。
速率限制	1,000次/分钟（默认）	按API密钥。突发允许：200次/10秒。企业层可配置。
速率限制头	`X-RateLimit-*`	每个响应返回限制、剩余、重置（Unix时间戳）。
错误	HTTP状态码 + JSON体	一致格式：`{"error": {"code", "message", "details", "request_id"}}`
幂等性	`Idempotency-Key`请求头	POST请求的安全重试。密钥存储24小时。
超时	30秒连接 / 60秒读取	长时间运行的操作返回异步作业ID用于轮询。

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "请求过多。限制：1000次/分钟。",
    "details": { "retry_after": "42s" },
    "request_id": "req_01HXYZ7K9P2Q3R4S5T6U7V8W9"
  }
}

Webhooks与事件

实时响应餐厅事件。

不要轮询——订阅。当餐厅数据中发生变化时，ClawPOS发送签名的webhook，从菜单变更到异常警报。

菜单

menu.updated

餐厅菜单变更——新菜品、价格更新、售罄或栏目重排。

分析

anomaly.detected

Claw Analytics标记了统计异常——营收飙升/下降、毛利变化、异常退单率。

智能体

agent.action_taken

AI员工执行了行动——活动启动、报告生成、建议发出。

数据

data.ingested

新一批餐厅数据成功摄取并处理到智能层中。

客户

customer.segment_changed

客户在细分之间移动——VIP→风险客、新客→常客、或流失→召回。

系统

integration.status

POS或数据源连接状态变更——已连接、断开或重新连接。

{
  "id": "wh_evt_01HXYZ...",
  "type": "anomaly.detected",
  "created": 1719504000,
  "data": {
    "restaurant_id": "rest_1234",
    "metric": "dinner_revenue",
    "deviation": "-22%",
    "severity": "high",
    "agent_url": "https://app.clawpos.com/agents/anomaly/abc123"
  }
}

安全与合规

企业级安全，默认启用。

餐厅数据是敏感的。我们如此对待——传输中和静态加密、访问控制、审计，并符合全球数据保护标准。

加密

传输中TLS 1.2+。静态AES-256。企业版可选客户管理密钥的每租户加密密钥。

SOC 2 Type II

独立审计的安全控制。年度第三方渗透测试。持续漏洞扫描。

GDPR与CCPA

可提供数据处理协议。访问、更正和删除权。数据驻留选项（美国、欧盟、亚太）。

访问控制

细粒度权限的RBAC。SSO（SAML 2.0、OIDC）。SCIM配置。企业版IP白名单。

审计日志

每次API调用、数据访问和智能体行动都记录请求ID。可导出审计追踪用于合规审查。

数据保留

可配置保留策略。匿名化选项。被遗忘权在请求后30天内履行。

AI餐厅经济的API

五大API。 一个智能层。