Decision API 快速入门：本地开发
在本地运行出款请求，查看事件契约和初始策略。示例使用合成数据与 local-baseline，不调用外部服务。该出款示例的国家上下文不一致返回 review、分数 55；这是开发策略结果，不是欺诈预测。
启动本地服务
使用 Python 3.10 或更新版本，在虚拟环境安装 requirements.txt，运行 uvicorn app.main:app --reload，向 localhost:8000 发送示例。本地配置了决策密钥时需带 X-API-Key；不要把开发示例发到未经批准的公开或试点端点。
理解结果
请求声明 country 为 MX、expected_country 为 ID。local-baseline 产生 identifier_present=true 与 country_context_match=false。初始策略因不一致增加 45 分，对非零分的出款再加 10 分，返回 review、risk_score=55 与 country_context_mismatch。每次 trace ID 和时间均变化。
下一步集成
依据响应参考，把策略决策与 HTTP 失败分别处理。真实信号需要与试点团队确定适配器、凭据和允许的数据范围。公开文档不会发放生产密钥，也不表示已开放真实核验沙箱。
可执行合成示例
python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/uvicorn app.main:app --reload
# In another terminal:
curl http://localhost:8000/api/v1/decisions/payout \
-H "Content-Type: application/json" \
-d '{
"event": "payout",
"subject": {
"email": "person@example.com"
},
"context": {
"country": "MX",
"expected_country": "ID",
"consent_reference": "synthetic-test-1"
},
"providers": [
"local-baseline"
]
}'下方仅展示部分响应字段，省略 trace ID、时间、证据与审计说明。
{
"event": "payout",
"decision": "review",
"risk_score": 55,
"reason_codes": [
"country_context_mismatch"
],
"providers_used": [
"local-baseline"
]
}来源与范围
依据 alpha 契约与代码；真实路由可用性需单独确认。