记录的 URL - Topify.ai

记录的 URL 是与项目关联、可用于 URL 驱动提示词发现的页面。记录 URL 本身不会创建提示词；如需生成候选提示词，请使用 URL 推荐端点。

列出记录的 URL

GET /projects/{project_id}/recording

curl "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/recording" \
  -H "X-API-Key: tk_live_..."

响应

{
  "code": 200,
  "message": "200 OK",
  "data": {
    "project_id": "a1b2c3d4-...",
    "total": 1,
    "urls": [
      {
        "id": "e5f6a7b8-...",
        "url": "https://acme.com/pricing",
        "normalized_url": "https://acme.com/pricing",
        "title": "Pricing | Acme",
        "icon_urls": ["https://www.google.com/s2/favicons?domain=acme.com&sz=128"],
        "created_at": "2026-07-13T12:00:00+00:00"
      }
    ]
  }
}

添加记录的 URL

POST /projects/{project_id}/recording

一次最多添加 50 个 URL。若省略 title，Topify 会在后台获取标题。

请求体

字段	类型	必填	说明
`urls`	object[]	是	1-50 个 URL 对象
`urls[].url`	string	是	页面 URL
`urls[].title`	string	否	页面标题；省略时异步获取

curl -X POST "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/recording" \
  -H "X-API-Key: tk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"urls":[{"url":"https://acme.com/pricing","title":"Pricing | Acme"}]}'

响应

{
  "code": 200,
  "message": "200 OK",
  "data": {
    "project_id": "a1b2c3d4-...",
    "affected_count": 1,
    "total_recorded": 4
  }
}

移除记录的 URL

DELETE /projects/{project_id}/recording

从记录列表中移除 URL。此操作不会删除提示词或提示词分析数据。

仅发送需要移除的 URL。当前 API 密钥对整个团队拥有完整权限。

curl -X DELETE "https://topify-customer-api-production.up.railway.app/api/public/v1/projects/{project_id}/recording" \
  -H "X-API-Key: tk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://acme.com/pricing"]}'

响应使用与添加端点相同的 affected_count 和 total_recorded 字段。