基础说明
所有接口请求必须遵循 RESTful 规范，基础 URL 为：
https://api.webarcx.com
提示： 为了确保提成收益 (6元)，请务必在调用生成接口时传入
invite 推广参数。
大部分接口需要 激活码 (activationCode) 进行认证。每个激活码可成功生成一次资料，失败不计费。
版权生成接口
POST 生成 Web 项目
主打接口。支持根据描述自动撰写说明书、提取代码清单并打包发送至邮箱。
/api/generate| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
| activationCode | string | YES | 网弧发放的有效激活码 |
| projectName | string | YES | 申请软件名称 (建议含'系统/平台') |
| projectReminder | string | YES | 功能关键词，逗号分隔 (页数依据此生成) |
| softVersionNumber | string | YES | 软件版本号，如 V1.0 |
| mailbox | string | YES | 接收结果文档压缩包的电子邮箱 |
| briefDescription | string | NO | 项目简介，有助于 AI 生成更专业的文档 |
| companyName | string | NO | 版权持有人，自动填入页眉版权信息 |
| logoUrl | string | NO | 项目 Logo 链接，用于说明书插图 |
| manualTemplate | int | NO | 模板 ID (1-4)，默认为 0 (随机) |
| invite | string | NO | 推广人 ID 或邮箱 |
Request Example
{
"activationCode": "WA-XXXX-XXXX",
"projectName": "智能物流仓储调配系统",
"projectReminder": "首页,入库管理,出库统计,库存预警,用户中心",
"softVersionNumber": "V1.0.5",
"mailbox": "admin@logistics.com",
"briefDescription": "一款提升仓库流转效率的 AI 调度平台"
}
Success Response
{
"code": 1,
"msg": "生成中，请稍后查看邮箱",
"data": []
}
Error Responses
// 激活码失效
{ "code": 0, "msg": "激活码错误，12月24日前购买的激活码已失效，请凭旧激活码发邮件兑换新激活码", "data": [] }
// 激活码无效
{ "code": 0, "msg": "激活码无效：请使用AI生成专属激活码", "data": [] }
// 已被使用
{ "code": 0, "msg": "已被使用", "data": [] }
// 任务在队列中
{ "code": 0, "msg": "该任务已在队列中，请稍后", "data": { "position": 3 } }
// 系统错误
{ "code": 0, "msg": "服务器错误，请联系790002517@qq.com", "data": [] }
其他项目类型接口：
- • App：
/api/app/generate - • 小程序：
/api/wechat/generate - • 桌面端：
/api/desktop/generate
* 以上接口参数格式与 Web 项目接口完全一致。
订单与管理查询
POST 订单状态查询
查询与激活码或邮箱关联的历史生成订单、当前进度及结果下载链接。
/api/queryOrderStatus| 参数 | 类型 | 必选 | 说明 |
|---|---|---|---|
| activationCode | string | YES | 查询凭证（可以是激活码或注册邮箱） |
| page | int | NO | 页码（默认为 1） |
| pageSize | int | NO | 每页条数（默认为 20） |
Success Response (JSON)
{
"code": 1,
"msg": "查询成功",
"data": {
"records": [
{
"code": "WA-XXXX-XXXX",
"projectName": "智能文档系统",
"logBody": "生成成功，下载链接：https://...",
"logTime": "2026-03-31T07:15:28.000Z"
}
],
"total": 1,
"page": 1
}
}
AI 智能辅助
POST 智能软著起名
通过行业描述，由 AI 生成 10 个高过审率的规范名称。
/api/projectNameGenerate关键参数： prompt (描述), type (项目类型)。
POST 智能生成关键词
根据项目名自动补全功能点，直接产出符合 12 页文档标准的提示词。
/api/keywordsGenerateSuccess Response
{
"code": 1,
"msg": "成功",
"data": ["首页", "数据监控", "报表统计", "权限管理"]
}
公共状态接口
GET 队列检查 V2
检查当前系统繁忙程度并提供名称预审建议。
/api/queueCheckV2?projectName=XXXPOST 当前任务排位
查询已提交的特定激活码任务在全局队列中的具体位置。
/api/queryQueuePosition任务处理流程
- 通过 API 提交任务，服务器返回受理成功（通常 1-2 秒）。
- 任务进入系统队列，AI 引擎开始撰写文档与提取代码。
- 预计 10-15 分钟内处理完毕（视队列人数而定）。
- 生成的 ZIP 压缩包通过 SMTP 自动发送至用户指定的邮箱。
