API 开发文档

RWA数字投行平台开发者接口文档

API 概览

RWA数字投行平台提供RESTful API，支持JSON格式的数据交换。所有API请求都需要通过HTTPS协议访问。

基础URL

https://your-domain.pages.dev/api

请求格式

用户认证

POST/users/login

用户登录接口，支持邮箱密码和钱包地址两种登录方式

请求参数

参数名 类型 必填 说明
email string 否 用户邮箱（邮箱登录时必填）
password string 否 用户密码（邮箱登录时必填）
walletAddress string 否 钱包地址（钱包登录时必填）

请求示例

{
  "email": "[email protected]",
  "password": "password123"
}

响应示例

{
  "success": true,
  "message": "登录成功",
  "data": {
    "user": {
      "id": "user123",
      "email": "[email protected]",
      "name": "用户名"
    },
    "token": "jwt_token_here"
  }
}

POST/users/register

用户注册接口

请求参数

参数名 类型 必填 说明
email string 是 用户邮箱
password string 是 用户密码
name string 是 用户姓名

项目管理

GET/projects

获取项目列表

查询参数

参数名 类型 必填 说明
page number 否 页码，默认为1
limit number 否 每页数量，默认为10
category string 否 项目分类筛选

响应示例

{
  "success": true,
  "data": {
    "projects": [
      {
        "id": "proj123",
        "name": "绿色能源项目",
        "category": "能源",
        "totalValue": 1000000,
        "status": "active"
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 50
    }
  }
}

POST/projects

创建新项目

请求参数

参数名 类型 必填 说明
name string 是 项目名称
description string 是 项目描述
category string 是 项目分类
totalValue number 是 项目总价值

AI风险评估

POST/ai-risk-assessment

AI智能风险评估接口

请求参数

参数名 类型 必填 说明
projectData object 是 项目数据对象
riskFactors array 是 风险因子数组

响应示例

{
  "success": true,
  "data": {
    "riskScore": 75,
    "riskLevel": "中等",
    "recommendations": [
      "建议增加流动性储备",
      "优化资产配置结构"
    ]
  }
}

错误代码

错误代码 HTTP状态码 说明
400 400 请求参数错误
401 401 未授权访问
403 403 权限不足
404 404 资源不存在
500 500 服务器内部错误