API 文档

快速开始 1

1. 申请密钥 → 前往 申请密钥 获取你的 API Key
2. 调用接口 → 使用以下示例调用同步接口

基础信息 2

• Base URL：https://api.xinirp.com/rg/v1
• 请求方式：POST
• 鉴权方式：Header X-RG-Key: your_api_key
• Content-Type：application/json

核心接口 · POST /sync 3

根据商家角色描述，自动匹配行业类目并返回规则组合

请求示例（curl）

curl -X POST https://api.xinirp.com/rg/v1/sync \
  -H "X-RG-Key: sk_rg_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "ag_merchant_001",
    "merchant_role": "我是一家律师事务所的行政主管"
  }'

请求参数

响应示例

{
  "code": 200,
  "data": {
    "agent_id": "ag_merchant_001",
    "merchant_role": "我是一家律师事务所的行政主管",
    "industry_category": "legal",
    "industry_name": "律师/法律服务",
    "match_keywords": ["律师"],
    "modules_delivered": ["M001","M004","M005","M011","M016","M023"],
    "rules_digest": "【系统运作规则】...",
    "version": "v3.6.0",
    "audit_id": "audit_20260701_120000_abc123"
  }
}

三种模式

• 角色自动匹配：传入 merchant_role → 自动匹配行业类目
• 目录模式：传入 ["*"] → 返回全模块目录 + 行业类目清单
• 手动模式：传入模块ID列表 → 返回指定模块

调试接口 · GET /match-debug 4

传入 merchant_role，返回匹配详情，不消耗额度

GET /rg/v1/match-debug?merchant_role=我是一家知识产权代理公司

健康检查 · GET /health 5

探测服务存活状态，无需鉴权

GET /rg/v1/health

行业类目 6

错误码 7