内容
# 决策.fyi 决策 API
> 驱动工作流应用程序的确定性决策 API 引擎,稳定的 MCP 公证人远程调用,决策备忘录数据包和执行门
[](https://decide.fyi)
[](https://modelcontextprotocol.io)
[](https://decide.fyi)
**定位:** Decide 是 API 引擎和兼容性接口。Krafthaus 工作流应用程序、Policy MCP 公证人、决策备忘录数据包和执行门是应用程序接口,它们重用相同的裁决、请求 ID 和证据合约。
## 生产确定性边界
绑定生产裁决应使用版本化的声明式规则手册:
运行时架构:参见 [`docs/RULEBOOK_RUNTIME_ARCHITECTURE.md`](docs/RULEBOOK_RUNTIME_ARCHITECTURE.md)。
机器可读模式:[`https://api.decide.fyi/schemas/rulebook-v1.schema.json`](https://api.decide.fyi/schemas/rulebook-v1.schema.json)。
活动运行时清单:[`https://api.decide.fyi/manifests/rulebook-runtime-v1.json`](https://api.decide.fyi/manifests/rulebook-runtime-v1.json)。
下游应用程序绑定:[`decide_application_binding_v1`](docs/APPLICATION_BINDING_V1.md)。
生产核心是 `hybrid_declarative_rulebook_with_trusted_adapters`:
直接声明式规则手册受支持,注册的第一方受信任适配器可以提供有界事实,而客户的可执行规则手册被拒绝。在两种支持的绑定模式中,规则手册 v1 仍然是唯一的绑定裁决选择。
```json
{
"mode": "rulebook",
"rulebook": {
"schema_version": "rulebook_v1",
"rulebook_id": "pricing_exception",
"version": "2026-06-11",
"input_schema": {
"required": ["discount_percent"],
"properties": {
"discount_percent": { "type": "number" }
}
},
"rules": [
{
"rule_id": "approve_standard_discount",
"priority": 50,
"condition": {
"field": "discount_percent",
"operator": "lte",
"value": 15
},
"outcome": {
"decision": "yes",
"verdict": "APPROVE",
"action": "approve_discount",
"reason_code": "WITHIN_STANDARD_LIMIT"
}
}
],
"default_outcome": {
"decision": "review",
"verdict": "REVIEW",
"action": "route_to_owner",
"reason_code": "NO_RULE_MATCHED"
}
},
"context": {
"inputs": {
"discount_percent": 10
}
}
}
```
`mode: "rulebook"` 不调用 LLM。它验证请求规则手册是否与发布的 JSON 模式一致,哈希规则手册,评估有界条件,并返回 `yes`、`no` 或 `review`,同时返回应用程序裁决、操作、原因代码、匹配规则和 `evaluator_version`。响应还包括 `rulebook_contract` 和强制模式 URL/哈希、`runtime_binding` 和直接或受信任适配器绑定模式、`input_hash`,即声明式评估器消耗的规范输入或适配器事实的 SHA-256 哈希,以及 `rulebook_attestation_v1` 捆绑哈希,涵盖确定性执行元组。
生产部署可以使用 `rulebook_attestation_signature_v1` Ed25519 信封签署该捆绑哈希;验证密钥发布在 `/.well-known/rulebook-attestation-keys.json`。在生产环境中设置 `DECIDE_RULEBOOK_ATTESTATION_SIGNATURE_REQUIRED=true` 以在返回未签名的规则手册决策时失败。发布已弃用的公钥及其历史记录 JSON,以便在轮换后仍然可以验证旧决策记录。
规则手册请求不能预加载 Decide 生成的决策记录材料。诸如 `runtime_binding`、`trusted_adapter`、`adapter_facts`、`rulebook_attestation`、`application_verdict` 和 `action` 等字段在请求正文、`context.inputs` 和适配器事实边界处仅为响应;尝试返回 `RULEBOOK_OUTPUT_MATERIAL_FORBIDDEN`。
旧的 `single`、`multi` 和 `runtime` 请求仍然可用于 AI 辅助探索,但它们不是绑定生产裁决。那些响应包括 `decision_contract` 和 `authority: "advisory_only"`,以及 `production_verdict: false`、`production_binding_required: true` 和支持的生产绑定模式;需要确定性执行的调用者必须使用 `mode: "rulebook"` 并捕获规则手册合约、`runtime_binding` 和规则手册证明材料。
在公共决策记录边界,成功的评估被注册为不可变的租户范围快照。历史重放恢复原始规范输入和存储的规则手册快照,而不是信任调用者覆盖或当前应用程序部署。
规则手册 v1 还支持注册的第一方受信任适配器,用于有界事实规范化。适配器请求固定了确切的语义版本和清单哈希;响应证明了捆绑的实现源哈希以及规范输入/输出哈希和强制执行合约。每次调用都在一个空环境工作器中运行,带有硬时间/资源限制,并拒绝常见的环境能力。声明式规则手册仍然是唯一的绑定裁决选择。参见 [`docs/TRUSTED_ADAPTERS_V1.md`](docs/TRUSTED_ADAPTERS_V1.md)。
当前的参考应用程序证明了两种生产模式:Solana 执行门、决策备忘录就绪门和 Krafthaus 工作流就绪绑定使用受信任的适配器,然后是规则手册 v1,而退款、试用、取消和退货政策 MCP 公证人直接向规则手册 v1 提供规范的事实,并通过其稳定的 REST 和 MCP 接口公开签署的规则手册结果。
在更改评估器、适配器或规则手册之前,请运行本地历史重放门:
```bash
npm run rulebook:migration-dry-run -- --json
```
使用 `--candidate-rulebook`、`--candidate-adapter` 和 `--candidate-evaluator-version` 来比较建议的迁移与黄金重放语料库,然后再进行生产路由更改。
对于发布门,请使用 `rulebook_migration_v1` 清单,以便审查候选工件、预期漂移和批准状态:
```bash
npm run rulebook:migration-dry-run -- --migration path/to/migration.json --json
```
清单模式发布在 `https://api.decide.fyi/schemas/rulebook-migration-v1.schema.json`,dry run 在重放之前根据该封闭模式验证清单。
在生产路由或运行时合约更改后,请运行生产运行时烟雾测试:
```bash
npm run smoke:rulebook-runtime
```
这将从运行时外部访问 `https://api.decide.fyi`,并验证发布的 `hybrid_declarative_rulebook_with_trusted_adapters` 清单、封闭的规则手册 v1 模式、证明密钥端点、直接声明式评估、可执行规则手册拒绝和仅限咨询的合约元数据在旧的 AI 辅助响应中。GitHub Actions 还作为计划/手动 **规则手册运行时生产烟雾测试** 工作流运行。
旧的 `single`、`multi` 和 `runtime` 模式是 AI 辅助接口。它们不是松散定义的商业判断的生产确定性边界。
架构:
- [生态系统宪章](docs/ECOSYSTEM_CONSTITUTION.md)
- [应用程序绑定合约](docs/APPLICATION_BINDING_V1.md)
- [规则手册 v1 合约](docs/RULEBOOK_V1.md)
- [规则手册兼容性政策](docs/RULEBOOK_COMPATIBILITY_POLICY.md)
- [规则手册迁移示例](docs/RULEBOOK_MIGRATION_EXAMPLES.md)
- [规则手册迁移清单](docs/RULEBOOK_MIGRATION_MANIFEST_V1.md)
## 一键安装
[](cursor://anysphere.cursor-deeplink/mcp/install?name=refund-decide&config=eyJ1cmwiOiAiaHR0cHM6Ly9yZWZ1bmQuZGVjaWRlLmZ5aS9hcGkvbWNwIn0=) [](https://insiders.vscode.dev/redirect/mcp/install?name=refund-decide&config=%7B%22type%22%3A%20%22http%22%2C%20%22url%22%3A%20%22https%3A//refund.decide.fyi/api/mcp%22%7D) [](#connect-via-mcp-claude-desktop--windsurf--other-clients) [](#connect-via-mcp-claude-desktop--windsurf--other-clients) [](#connect-via-mcp-claude-desktop--windsurf--other-clients) [](#connect-via-mcp-claude-desktop--windsurf--other-clients)
> 按钮安装 **退款公证人** 服务器。要添加所有 4 个服务器,请使用下面的 [JSON 配置](#connect-via-mcp-claude-desktop--windsurf--other-clients)。
## 稳定的 MCP 远程服务器
| 服务器 | 域名 | 工具 | 裁决 |
|--------|--------|------|----------|
| **退款公证人** | [refund.decide.fyi](https://refund.decide.fyi) | `refund_eligibility` | ALLOWED / DENIED / UNKNOWN |
| **取消公证人** | [cancel.decide.fyi](https://cancel.decide.fyi) | `cancellation_penalty` | FREE_CANCEL / PENALTY / LOCKED / UNKNOWN |
| **退货公证人** | [return.decide.fyi](https://return.decide.fyi) | `return_eligibility` | RETURNABLE / EXPIRED / NON_RETURNABLE / UNKNOWN |
| **试用公证人** | [trial.decide.fyi](https://trial.decide.fyi) | `trial_terms` | TRIAL_AVAILABLE / NO_TRIAL / UNKNOWN |
所有服务器:100 个供应商,美国地区,个人计划,无身份验证,100 请求/分钟。运行时合约和参考证据保留在此。
## 快速开始
### 通过 MCP 连接(Claude Desktop / Windsurf / 其他客户端)
```json
{
"mcpServers": {
"refund-decide": { "url": "https://refund.decide.fyi/api/mcp" },
"cancel-decide": { "url": "https://cancel.decide.fyi/api/mcp" },
"return-decide": { "url": "https://return.decide.fyi/api/mcp" },
"trial-decide": { "url": "https://trial.decide.fyi/api/mcp" }
}
}
```
### REST API
```bash
# 退款资格
curl -X POST https://refund.decide.fyi/api/v1/refund/eligibility \
-H "Content-Type: application/json" \
-d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'
# 取消罚款
curl -X POST https://cancel.decide.fyi/api/v1/cancel/penalty \
-H "Content-Type: application/json" \
-d '{"vendor":"adobe","region":"US","plan":"individual"}'
# 退货资格
curl -X POST https://return.decide.fyi/api/v1/return/eligibility \
-H "Content-Type: application/json" \
-d '{"vendor":"adobe","days_since_purchase":12,"region":"US","plan":"individual"}'
# 试用条款
curl -X POST https://trial.decide.fyi/api/v1/trial/terms \
-H "Content-Type: application/json" \
-d '{"vendor":"adobe","region":"US","plan":"individual"}'
```
### 本地开发检查
启动本地开发服务器:
```bash
npx vercel dev
```
在单独的终端中:
```bash
# 处理级别的烟雾检查(不需要运行服务器)
npm run smoke
# MCP 端点检查(需要运行服务器)
npm run mcp:check
# 自包含的本地 MCP 检查;启动/停止 localhost:3000 上的 vercel dev
npm run mcp:check:local
# 端到端工作流夹具(示例 -> 结果)
npm run workflow:test
# 生产客户密钥验证(在配置密钥后)
DECIDE_SMOKE_API_KEY='<customer-key>' npm run smoke:customer-key
```
---
## Zendesk 工作流协调器
使用工作流端点时,您希望一个请求返回:
- `/api/decide` 的决策分类(`yes | no`)
- 相关公证人端点的策略结果
- 推荐的 Zendesk 操作 + 标签 + 私有笔记,附带 `request_id`
**端点**
- `POST https://refund.decide.fyi/api/v1/workflows/zendesk/refund`
- `POST https://cancel.decide.fyi/api/v1/workflows/zendesk/cancel`
- `POST https://return.decide.fyi/api/v1/workflows/zendesk/return`
- `POST https://trial.decide.fyi/api/v1/workflows/zendesk/trial`
### 请求
```json
{
"ticket_id": "ZD-9001",
"workflow_type": "refund",
"question": "Should this Adobe annual plan refund request proceed under policy?",
"vendor": "adobe",
"region": "US",
"plan": "individual",
"days_since_purchase": 5
}
```
对于 `refund` 和 `return`,请包含 `days_since_purchase`。
### 确定性测试模式
设置 `decision_override` 以绕过夹具和 CI 中的模型分类:
```json
{
"decision_override": "yes"
}
```
### 响应(示例)
```json
{
"ok": true,
"flow": "zendesk_refund_v1",
"ticket_id": "ZD-9001",
"decision": { "c": "yes", "request_id": "req_123" },
"policy": { "verdict": "ALLOWED", "code": "WITHIN_WINDOW" },
"action": {
"type": "approve_refund",
"zendesk_tags": ["decide", "decide_yes", "refund_allowed"]
}
}
```
---
## 退款公证人
**端点:** `POST https://refund.decide.fyi/api/v1/refund/eligibility`
**MCP 工具:** `refund_eligibility`
检查订阅购买是否在供应商的退款窗口内。
**输入:** `vendor`、`days_since_purchase`、`region`、`plan`
```json
{"refundable":true,"verdict":"ALLOWED","code":"WITHIN_WINDOW","message":"Refund is allowed. Purchase is 12 day(s) old, within 14 day window.","vendor":"adobe","window_days":14}
```
**代码:** `WITHIN_WINDOW`、`OUTSIDE_WINDOW`、`NO_REFUNDS`、`UNSUPPORTED_VENDOR`
## 取消公证人
**端点:** `POST https://cancel.decide.fyi/api/v1/cancel/penalty`
**MCP 工具:** `cancellation_penalty`
检查取消罚款 — 提前终止费用、合同锁定或免费取消。
**输入:** `vendor`、`region`、`plan`
```json
{"verdict":"PENALTY","code":"EARLY_TERMINATION_FEE","message":"adobe charges an early termination fee: 50% of remaining months on annual plan.","vendor":"adobe","policy":"etf"}
```
**代码:** `NO_PENALTY`、`EARLY_TERMINATION_FEE`、`CONTRACT_LOCKED`、`UNSUPPORTED_VENDOR`
## 退货公证人
**端点:** `POST https://return.decide.fyi/api/v1/return/eligibility`
**MCP 工具:** `return_eligibility`
检查订阅购买是否可以退货/反转,带有退货类型和方法。
**输入:** `vendor`、`days_since_purchase`、`region`、`plan`
```json
{"returnable":true,"verdict":"RETURNABLE","code":"FULL_RETURN","message":"Return is available. Purchase is 5 day(s) old, within 14-day window.","vendor":"adobe","return_type":"full_refund","method":"self_service"}
```
**代码:** `FULL_RETURN`、`PRORATED_RETURN`、`CREDIT_RETURN`、`OUTSIDE_WINDOW`、`NO_RETURNS`、`UNSUPPORTED_VENDOR`
## 试用公证人
**端点:** `POST https://trial.decide.fyi/api/v1/trial/terms`
**MCP 工具:** `trial_terms`
检查免费试用可用性、长度、卡要求和自动转换状态。
**输入:** `vendor`、`region`、`plan`
```json
{"verdict":"TRIAL_AVAILABLE","code":"AUTO_CONVERTS","message":"adobe offers a 7-day free trial. Credit card required. Auto-converts to paid plan.","vendor":"adobe","trial_days":7,"card_required":true,"auto_converts":true}
```
**代码:** `AUTO_CONVERTS`、`NO_AUTO_CONVERT`、`TRIAL_NOT_AVAILABLE`、`UNSUPPORTED_VENDOR`
```
## 支持的供应商(100)
| 供应商 | 标识符 | 退款 | 取消 | 退货 | 试用 |
|--------|-----------|--------|--------|--------|-------|
| 1Password | `1password` | 无退款 | 免费 | 无退货 | 14天 |
| Adobe | `adobe` | 14天 | 免费 | 14天全额 | 7天 |
| Amazon Prime | `amazon_prime` | 3天 | 免费 | 3天全额 | 30天 |
| Apple 应用商店 | `apple_app_store` | 14天 | 免费 | 14天全额 | - |
| Apple Music | `apple_music` | 无退款 | 免费 | 无退货 | 30天 |
| Apple TV+ | `apple_tv_plus` | 无退款 | 免费 | 无退货 | 7天 |
| Audible | `audible` | 无退款 | 免费 | 无退货 | 30天 |
| Bitwarden | `bitwarden` | 30天 | 免费 | 30天全额 | 7天 |
| Bumble | `bumble` | 无退款 | 免费 | 无退货 | 7天 |
| Calm | `calm` | 30天 | 免费 | 30天全额 | 7天 |
| Canva | `canva` | 无退款 | 免费 | 无退货 | 30天 |
| ChatGPT Plus | `chatgpt_plus` | 无退款 | 免费 | 无退货 | - |
| Claude Pro | `claude_pro` | 无退款 | 免费 | 无退货 | - |
| Coursera Plus | `coursera_plus` | 14天 | 免费 | 14天全额 | 7天 |
| Crunchyroll | `crunchyroll` | 无退款 | 免费 | 无退货 | 7天 |
| Deezer | `deezer` | 无退款 | 免费 | 无退货 | 30天 |
| Disney+ | `disney_plus` | 无退款 | 免费 | 无退货 | - |
| DoorDash DashPass | `doordash_dashpass` | 无退款 | 免费 | 无退货 | 30天 |
| Dropbox (美国) | `dropbox_us` | 无退款 | 免费 | 无退货 | 30天 |
| Duolingo | `duolingo` | 无退款 | 免费 | 无退货 | 14天 |
| Evernote | `evernote` | 20天 | 免费 | 20天全额 | 14天 |
| ExpressVPN | `expressvpn` | 30天 | 免费 | 30天全额 | 7天 |
| Figma | `figma` | 无退款 | 免费 | 无退货 | 30天 |
| Fubo TV | `fubo_tv` | 无退款 | 免费 | 无退货 | 7天 |
| GitHub Pro | `github_pro` | 无退款 | 免费 | 无退货 | - |
| Google Play | `google_play` | 2天 | 免费 | 2天全额 | - |
| Grammarly | `grammarly` | 无退款 | 免费 | 无退货 | 7天 |
| Headspace | `headspace` | 无退款 | 免费 | 无退货 | 7天 |
| HelloFresh | `hellofresh` | 无退款 | 免费(5天通知) | 无退货 | - |
| Hinge | `hinge` | 无退款 | 免费 | 无退货 | 7天 |
| Hulu | `hulu` | 无退款 | 免费 | 无退货 | 30天 |
| iCloud+ | `icloud_plus` | 14天 | 免费 | 14天全额 | - |
| Instacart+ | `instacart_plus` | 5天 | 免费 | 5天全额 | 14天 |
| LinkedIn Premium | `linkedin_premium` | 7天 | 免费 | 7天全额 | 30天 |
| MasterClass | `masterclass` | 30天 | 免费 | 30天全额 | - |
| Max (HBO) | `max` | 无退款 | 免费 | 无退货 | - |
| Microsoft 365 | `microsoft_365` | 30天 | 免费 | 30天全额 | 30天 |
| Midjourney | `midjourney` | 无退款 | 免费 | 无退货 | - |
| Netflix | `netflix` | 无退款 | 免费 | 无退货 | - |
| Nintendo Switch Online | `nintendo_switch_online` | 无退款 | 免费 | 无退货 | 7天 |
| Noom | `noom` | 14天 | 免费 | 14天全额 | 7天 |
| NordVPN | `nordvpn` | 30天 | 免费 | 30天全额 | 7天 |
| Notion | `notion` | 3天 | 免费 | 3天全额 | - |
| Paramount+ | `paramount_plus` | 无退款 | 免费 | 无退货 | 7天 |
| Peacock | `peacock` | 无退款 | 免费 | 无退货 | 7天 |
| Peloton | `peloton` | 无退款 | 免费 | 无退货 | 30天 |
| PlayStation Plus | `playstation_plus` | 14天 | 免费 | 14天按比例 | 14天 |
| Scribd | `scribd` | 30天 | 免费 | 30天全额 | 30天 |
| Shutterstock | `shutterstock` | 无退款 | ETF | 无退货 | 30天 |
| Slack | `slack` | 无退款 | 免费 | 积分 | 90天 |
| Sling TV | `sling_tv` | 无退款 | 免费 | 无退货 | - |
| Spotify | `spotify` | 无退款 | 免费 | 无退货 | 30天 |
| Squarespace | `squarespace` | 14天 | 免费 | 14天全额 | 14天 |
| Strava | `strava` | 14天 | 免费 | 14天全额 | 30天 |
| Surfshark | `surfshark` | 30天 | 免费 | 30天全额 | 7天 |
| Tidal | `tidal` | 无退款 | 免费 | 无退货 | 30天 |
| Tinder | `tinder` | 无退款 | 免费 | 无退货 | - |
| Todoist | `todoist` | 30天 | 免费 | 30天全额 | 30天 |
| Twitch | `twitch` | 无退款 | 免费 | 无退货 | - |
| Walmart+ | `walmart_plus` | 无退款 | 免费 | 无退货 | 30天 |
| Wix | `wix` | 14天 | 免费 | 14天全额 | 14天 |
| Xbox Game Pass | `xbox_game_pass` | 30天 | 免费 | 30天全额 | 14天 |
| YouTube Premium | `youtube_premium` | 无退款 | 免费 | 无退货 | 30天 |
| Zoom | `zoom` | 无退款 | 免费 | 无退货 | - |
**范围:** 美国地区,仅限个人计划。
## 数据新鲜度
政策来源于官方供应商文档和服务条款。
- **每日自动检查** — GitHub Action 在 08:00 UTC 运行,哈希所有 4 个服务的供应商政策页面(退款、取消、退货、试用)。如果页面发生变化,将开启一个问题进行审查。
- **政策源 URL 跟踪** — 每个服务都有自己的 `rules/` 源文件,链接到官方政策页面。
- **合规性导出** — `GET /api/compliance-export` 返回跟踪源、哈希和待处理候选更改的 CSV 快照(`?format=json` 用于机器可读输出)。
- **版本化规则** — 每个规则文件都包含一个 `rules_version` 字段,用于检测过时。
## 架构
- **无状态** — 无数据库,无会话,无副作用
- **确定性** — 相同的输入始终产生相同的输出
- **版本化规则** — 规则文件包括用于跟踪更改的版本
- **每日监控** — GitHub Action 每天检查所有供应商政策页面
- **无服务器** — 在 Vercel 无服务器函数上运行
- **零依赖** — 核心计算逻辑没有外部依赖
- **主机名路由** — Vercel 中间件将子域名路由到正确的 MCP 端点
## 限制
- **仅限美国** — 目前仅支持美国地区
- **仅限个人计划** — 商业/企业计划暂不支持
- **日历天数** — 窗口基于日历天数,非工作日
- **静态规则** — 不考虑促销优惠或特殊情况
## 更新日志
### 未发布
**新增:**
- `GET /api/compliance-export` 端点,用于导出政策监控证据(默认 CSV,JSON 格式通过 `?format=json`)。
- 合规性导出 JSON 和 CSV 路径的烟雾测试覆盖。
**更改:**
- 登陆页面现在将 Decide 定位为决策 API 引擎,并将 Policy MCP Notaries 框架为一个参考应用程序。
### v1.2.1 (2026-02-08)
**更改:**
- 子域名首页现在显示相关 notary 卡(退款/取消/退货/试用)。
- 版本元数据在 `server.json`、MCP `initialize` 和 `/.well-known/*` 中保持一致。
### v1.2.0 (2026-02-02)
**新增:**
- 取消 Notary MCP(cancel.decide.fyi)— 取消罚则检查器
- 退货 Notary MCP(return.decide.fyi)— 退货资格检查器
- 试用 Notary MCP(trial.decide.fyi)— 免费试用条款检查器
- 基于主机名的中间件路由,适用于所有子域名
- 政策源文件和每日检查取消、退货和试用政策
- 系统/代理模式框架在登陆页面
- 包含所有 4 个服务器的 MCP 目录
**修复:**
- 每日政策检查器:添加 `contents:write` 权限并修复 shell 逻辑
- 删除导致 404 错误的死 Cloudflare 电子邮件解码脚本
### v1.1.0 (2026-02-01)
**新增:**
- 从 64 个支持供应商扩展到 100 个
- 每日政策检查 GitHub Action(cron 于 08:00 UTC)
- `rules/policy-sources.json` 中的政策源 URL 跟踪
- 输入模式中的 MCP 供应商 `enum` 用于代理可发现性
**修复:**
- Vercel 上的 `ERR_IMPORT_ATTRIBUTE_MISSING` 崩溃(Node 22 导入属性)
### v1.0.0 (2026-01-15)
**新增:**
- 初始版本,包含 REST API 和 MCP 服务器
- 支持 9 个供应商
## 免费 API(默认:无身份验证)
所有 4 个政策服务器均免费使用。无身份验证。无 API 密钥。
`/api/decide` 默认情况下是公开的,可以通过在服务器环境变量中设置 `DECIDE_API_KEY` 来保护。
如果您在 `decidesite` 代理后面运行 `decide`,并使用动态客户密钥,请设置:
- `DECIDE_PROXY_SHARED_TOKEN`:受信任的代理调用所需的共享密钥,在 `x-decide-proxy-token` 头中。
- `DECIDE_API_KEY`:后端内部密钥,受信任的代理转发上游(建议保持后端私有)。
速率限制:每分钟 100 次请求/ IP。
有关首位客户交接和密钥生产验证,请参见 [`docs/FIRST_CUSTOMER_RUNBOOK.md`](docs/FIRST_CUSTOMER_RUNBOOK.md)。
### 政策获取钩子(适用于政策检查器浏览器钩子通道)
使用 `POST /api/policy-fetch-hook` 作为每日检查器的获取适配器,当直接获取被阻止时。
请求体:
```json
{
"url": "https://example.com/policy",
"vendor": "example_vendor",
"policy_type": "refund",
"timeout_ms": 18000
}
```
身份验证:
- `Authorization: Bearer <POLICY_CHECK_BROWSER_HOOK_TOKEN>` 或 `x-hook-token: <token>`
服务器环境:
- `POLICY_CHECK_BROWSER_HOOK_TOKEN` (端点身份验证所需)
- `POLICY_FETCH_BROWSERLESS_TOKEN` (可选;启用无浏览器渲染先)
- `POLICY_FETCH_BROWSERLESS_CONTENT_URL` (可选覆盖;默认 `https://chrome.browserless.io/content`)
- `POLICY_FETCH_ALLOWED_HOSTS` (可选逗号分隔主机允许列表)
检查器(GitHub Actions,仓库 `decide`):
- 机密 `POLICY_CHECK_BROWSER_HOOK_URL` = 部署的端点 URL(示例:`https://decide-1.vercel.app/api/policy-fetch-hook`)
- 机密 `POLICY_CHECK_BROWSER_HOOK_TOKEN` = 与运行时环境相同的令牌
- 变量 `POLICY_CHECK_FETCH_LANES_DEFAULT` = `browser_hook,direct,zendesk_api,mirror`
有疑问?请联系 [support@decide.fyi](mailto:support@decide.fyi) 或 [@decidefyi on X](https://x.com/decidefyi)。
## 链接
- **网站:** [https://decide.fyi](https://decide.fyi)
- **政策警报:** [https://www.decide.fyi/resources/policy-alerts](https://www.decide.fyi/resources/policy-alerts)
- **退款:** [https://refund.decide.fyi](https://refund.decide.fyi)
- **取消:** [https://cancel.decide.fyi](https://cancel.decide.fyi)
- **退货:** [https://return.decide.fyi](https://return.decide.fyi)
- **试用:** [https://trial.decide.fyi](https://trial.decide.fyi)
- **X/Twitter:** [@decidefyi](https://x.com/decidefyi)
- **MCP 规范:** [https://modelcontextprotocol.io](https://modelcontextprotocol.io)
---
Decide 是 API 引擎。应用程序证明基本功能。
MCP 配置
以下是此 MCP Server 的配置信息,可直接复制到 Cursor 或其他 MCP 客户端中使用。
mcp.json
连接信息
猜你喜欢
暂无推荐服务器