API 参考

自定义域名

为您的项目添加、验证和移除自定义域名。

最后更新： 2026年5月28日

Custom Domains API

管理项目的自定义域名。自定义域名需要 Pro 或 Business 订阅计划。

获取域名状态

GET /api/v1/projects/{projectId}/domain

返回项目当前的自定义域名配置，若未设置则返回 null。

添加自定义域名

POST /api/v1/projects/{projectId}/domain

{ "domain": "myapp.example.com" }

为已上线的项目添加自定义域名。响应中包含需要在您的域名注册商处配置的 DNS 记录：

{
  "data": {
    "domain": { ... },
    "dnsRecords": [
      { "type": "CNAME", "host": "myapp.example.com", "value": "my-project.floop.tech" },
      { "type": "TXT", "host": "_floopfloop-verify.myapp.example.com", "value": "verify-token" }
    ]
  }
}

移除自定义域名

DELETE /api/v1/projects/{projectId}/domain

从项目中移除自定义域名。

文件上传

POST /api/v1/uploads

生成用于上传文件（图片、PDF、文本）的预签名 S3 URL。在创建或优化项目时，将返回的 key 用于attachments 数组中。

{
  "fileName": "screenshot.png",
  "fileType": "image/png",
  "fileSize": 123456
}

响应：

{
  "data": {
    "uploadUrl": "https://s3.amazonaws.com/...",
    "key": "uploads/userId/fileId/screenshot.png",
    "fileId": "uuid"
  }
}

收到上传 URL 后，使用匹配的 Content-Type 请求头直接将文件 PUT 至该 URL。