API文档

集成IdeaValidator.ai到您的应用中，程序化地验证软件想法

快速开始

快速开始

几分钟内开始使用我们的API

🔑

1. 获取API密钥

注册账户后在控制台生成您的API密钥

📡

2. 发送请求

使用HTTP POST向我们的端点发送想法数据

📊

3. 获取结果

轮询验证状态并获取详细的分析报告

API端点

完整的RESTful API接口文档

POST/api/validate

想法验证

提交软件想法进行全面分析验证

参数

title必需string

想法标题

description必需string

详细描述

targetUsers必需string

目标用户群体

techStack可选array

技术栈列表

teamInfo必需object

团队信息

示例

请求
{
  "title": "AI代码审查助手",
  "description": "帮助开发者自动识别代码问题并提供优化建议的AI工具",
  "targetUsers": "中小型开发团队的技术主管和资深开发者",
  "techStack": ["React", "Node.js", "OpenAI API"],
  "teamInfo": {
    "size": 3,
    "experience": "2-5年",
    "skills": ["前端开发", "后端开发", "AI/ML"]
  }
}
响应
{
  "success": true,
  "data": {
    "id": "val_12345",
    "status": "processing",
    "estimatedTime": 600
  }
}
GET/api/validate/{id}

获取验证结果

根据验证ID获取分析结果

参数

id必需string

验证任务ID

示例

请求
GET /api/validate/val_12345
响应
{
  "success": true,
  "data": {
    "id": "val_12345",
    "status": "completed",
    "result": {
      "marketScore": 8.5,
      "techScore": 7.2,
      "teamScore": 8.8,
      "overallScore": 8.2,
      "insights": [...],
      "recommendations": [...],
      "reportUrl": "https://reports.ideavalidator.ai/val_12345.pdf"
    }
  }
}
GET/api/trends/{keyword}

市场趋势数据

获取特定关键词的市场趋势数据

参数

keyword必需string

搜索关键词

timeframe可选string

时间范围 (1m, 3m, 6m, 1y)

region可选string

地区代码

示例

请求
GET /api/trends/ai-coding-assistant?timeframe=6m&region=CN
响应
{
  "success": true,
  "data": {
    "keyword": "ai-coding-assistant",
    "timeframe": "6m",
    "region": "CN",
    "trend": [
      {"date": "2024-07-01", "value": 45},
      {"date": "2024-08-01", "value": 52},
      {"date": "2024-09-01", "value": 67}
    ],
    "relatedQueries": [...],
    "growthRate": "+48%"
  }
}

身份验证

安全地访问API服务

API密钥认证

在请求头中包含API密钥

Authorization: Bearer your_api_key_here

🔒 所有API密钥都经过加密存储和传输

JWT令牌

使用JWT令牌进行用户身份验证

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

🔒 令牌有效期为24小时，自动刷新

请求限制

不同套餐的API调用限制

套餐每日限制突发限制说明
免费版10 / day3 / 分钟适合测试和小型项目
基础版100 / day10 / 分钟个人开发者推荐
专业版500 / day20 / 分钟团队和频繁使用
企业版unlimited 50 / 分钟大型企业和定制需求

SDK和示例代码

多种编程语言的官方SDK

JavaScript/Node.js

安装命令：npm install ideavalidator-js

const IdeaValidator = require('ideavalidator-js');
const client = new IdeaValidator('your_api_key');

const result = await client.validate({
  title: 'My App Idea',
  description: 'A revolutionary mobile app...',
  targetUsers: 'Young professionals',
  techStack: ['React Native', 'Firebase']
});

Python

安装命令：pip install ideavalidator-python

from ideavalidator import IdeaValidator

client = IdeaValidator(api_key='your_api_key')

result = client.validate({
    'title': 'My App Idea',
    'description': 'A revolutionary mobile app...',
    'target_users': 'Young professionals',
    'tech_stack': ['React Native', 'Firebase']
})

cURL

安装命令：系统自带，无需安装

curl -X POST https://api.ideavalidator.ai/validate \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My App Idea",
    "description": "A revolutionary mobile app...",
    "targetUsers": "Young professionals"
  }'

状态码说明

HTTP状态码和错误处理

状态码描述说明
200OK请求成功
202Accepted验证任务已接受，正在处理
400Bad Request请求参数错误
401UnauthorizedAPI密钥无效或过期
429Too Many Requests超出请求限制
500Internal Server Error服务器内部错误

需要帮助？

我们的技术团队随时为您的集成项目提供支持

技术支持API反馈