API文档

PolicyPilot API 采用 RESTful 设计，支持 HTTPS 协议。所有请求都需要携带 API Key 进行认证。返回数据格式为 JSON，请确保您的应用正确处理响应。

Base URL

https://qiai.ren

认证

所有 API 请求都需要在 Header 中携带 API Key 进行认证。注册后您会获得一个 API Key，请妥善保管，切勿泄露。

请求头

            Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
          

快速开始

以下示例展示如何使用 cURL 和 Python 调用 PolicyPilot API。

cURL

bash

            # 注册获取 API Key
curl -X POST https://qiai.ren/api/token/register \
  -H "Content-Type: application/json" \
  -d '{"company_name": "示例公司", "contact_email": "demo@example.com", "contact_phone": "13800138000"}'

# 查询政策
curl -X POST https://qiai.ren/match \
  -H "Content-Type: application/json" \
  -d '{"company_name": "深圳腾讯", "region": "深圳"}'
          

Python

python

            import requests

# 注册获取 API Key
response = requests.post(
    "https://qiai.ren/api/token/register",
    json={
        "company_name": "示例公司",
        "contact_email": "demo@example.com",
        "contact_phone": "13800138000"
    }
)
api_key = response.json()["api_key"]

# 查询政策
response = requests.post(
    "https://qiai.ren/match",
    json={
        "company_name": "深圳腾讯",
        "region": "深圳"
    }
)
policies = response.json()["data"]
          

POST /api/token/register

注册客户

注册新客户，获取 API Key。此接口不需要认证。

请求参数

参数名	类型	说明
company_name必填	string	公司名称
contact_email必填	string	联系邮箱
contact_phone必填	string	联系电话

请求示例

              {
  "company_name": "深圳科技创新有限公司",
  "contact_email": "contact@company.com",
  "contact_phone": "13800138000"
}
            

响应示例

              {
  "success": true,
  "message": "注册成功",
  "api_key": "pk_live_xxxxxxxxxxxx",
  "balance": 0
}
            

POST /api/token/recharge

充值

为账户充值，余额实时到账。

参数名	类型	说明
api_key必填	string	API Key（Header 或 Body 中传递）
amount必填	number	充值金额（元），最低 10 元

在线测试

POST /api/token/query

基础查询

简单的政策关键词查询，适用于简单的政策检索场景。费用：0.1 元/次

参数名	类型	说明
api_key必填	string	API Key
query必填	string	查询关键词
region可选	string	地区筛选
category可选	string	政策类别

POST /api/token/query/advanced

高级查询

AI 智能匹配，根据企业画像精准推荐政策。费用：0.5 元/次

参数名	类型	说明
api_key必填	string	API Key
query必填	string	查询描述
company_profile可选	string	企业简介，用于更精准的匹配
region可选	string	地区筛选
category可选	string	政策类别

GET /api/token/balance

查询余额

查询当前账户余额

请求示例

GET /api/token/balance?api_key=YOUR_API_KEY

响应示例

              {
  "success": true,
  "balance": 100.50
}
            

GET /api/token/usage

用量统计

查询 API 调用统计

响应示例

              {
  "success": true,
  "total_calls": 1250,
  "basic_calls": 1000,
  "advanced_calls": 250,
  "total_cost": 225.00
}
            

GET /api/token/bill

账单记录

查询最近 100 条账单记录

响应示例

              {
  "success": true,
  "bills": [
    {
      "id": "bill_xxx",
      "type": "query",
      "amount": -0.10,
      "balance": 99.90,
      "created_at": "2024-01-15T10:30:00Z"
    }
  ]
}
            

POST /match

政策匹配

根据企业信息匹配相关政策。此接口不需要认证，适合在官网展示。

参数名	类型	说明
company_name必填	string	企业名称
region可选	string	地区
industry可选	string	行业

在线测试

POST /api/partner/chat

AI 对话

与政策 AI 助手对话，获取政策解读和建议。

参数名	类型	说明
message必填	string	用户消息
conversation_id可选	string	对话 ID，用于连续对话

请求示例

              {
  "message": "广州海珠区有什么科技创新补贴？",
  "conversation_id": "conv_xxx"  // 可选
}
            

错误码

API 返回的错误码说明

错误码	说明
1001	缺少必要参数
1002	参数格式错误
2001	API Key 无效
2002	API Key 已过期
3001	余额不足
4001	请求频率超限
5001	服务器内部错误

定价说明

PolicyPilot 采用按查询计费模式，无月费、无年费

            计费规则
          
基础查询   0.1 元/次    - 关键词检索、地区筛选
高级查询   0.5 元/次    - AI 智能匹配、企业画像
AI 对话     0.5 元/次    - 自然语言交互

最低充值金额：10 元
余额永久有效，无过期时间