API文档

AI云营提供完整的RESTful API接口,支持与第三方系统集成

认证方式

所有API请求都需要在请求头中携带Token进行认证:

Authorization: Bearer YOUR_API_TOKEN

获取Token:发送POST请求到 /api/auth/login,传入用户名和密码。

{
    "username": "your_username",
    "password": "your_password"
}

// 响应
{
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expires_in": 86400
}

基础URL

https://api.aiyunying.com/v1

所有API端点都在此基础上拼接。

核心API

智能体管理

方法 端点 说明
GET /api/agents 获取所有智能体列表
GET /api/agents/{name} 获取指定智能体详情
POST /api/agents/{name}/execute 执行智能体任务

任务管理

方法 端点 说明
GET /api/tasks 获取任务列表
POST /api/tasks 创建新任务
GET /api/tasks/{id} 获取任务详情

数据看板

方法 端点 说明
GET /api/dashboard/summary 获取数据概览
GET /api/business/performance 获取业绩数据

平台接管

方法 端点 说明
POST /api/website/detect 检测网站类型
POST /api/website/connect 连接网站
GET /api/website/connections 获取已连接网站

请求示例

cURL

curl -X GET "https://api.aiyunying.com/v1/agents" \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json"

Python

import requests

url = "https://api.aiyunying.com/v1/agents"
headers = {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

JavaScript

const response = await fetch('https://api.aiyunying.com/v1/agents', {
    method: 'GET',
    headers: {
        'Authorization': 'Bearer YOUR_TOKEN',
        'Content-Type': 'application/json'
    }
});

const data = await response.json();
console.log(data);

错误代码

状态码 说明 处理建议
200 请求成功 -
400 请求参数错误 检查请求参数
401 未授权 检查Token是否有效
403 禁止访问 检查权限配置
404 资源不存在 检查请求URL
500 服务器错误 稍后重试或联系客服

需要帮助?

查看完整API文档或联系技术支持

联系技术支持