餐廳智能平臺 - 面向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

將原始運營數據轉化為預測、績效信號和可執行的商業洞察。

銷售預測與需求預測
菜單 performance & 利潤率 analysis
異常檢測與告警

GET/v1/analytics/sales/預測

GET/v1/analytics/menu/performance

POST/v1/analytics/anomalies

GET/v1/analytics/reports

代理 API

在已經理解您業務的智能層上構建和部署餐廳AI員工——無需提示工程。

Pre-built agent personas (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。 一個智能層。