API 接口文档

curl -sS --get "$BASE_URL/panSeo/openApi/search" \
  -H "Accept: application/json" \
  -H "x-token: $TOKEN" \
  --data-urlencode "q=Go 教程" \
  --data-urlencode "platform=quark" \
  --data-urlencode "page=1" \
  --data-urlencode "pageSize=20"

{
  "name": "Go Web 开发资料",
  "url": "https://pan.quark.cn/s/demo-resource",
  "extractionCode": "1234",
  "available": true,
  "lastCheckedAt": "2026-08-18T17:30:00+08:00"
}

curl -sS -X POST "$BASE_URL/panSeo/openApi/resources/upsert" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "x-token: $TOKEN" \
  --data '{"name":"Go Web 开发资料","url":"https://pan.quark.cn/s/demo-resource","extractionCode":"1234","available":true}'

{
  "source": "partner-crawler",
  "externalId": "go-web-20260818-001",
  "title": "Go Web 开发资料",
  "slug": "go-web-guide",
  "summary": "包含 Gin、数据库和部署相关资料。",
  "contentMarkdown": "## 内容介绍\n\n这是一份持续更新的 Go Web 学习资料。",
  "coverUrl": "https://cdn.example.com/covers/go-web.webp",
  "categoryId": 3,
  "status": "published",
  "publishedAt": "2026-08-18T15:20:00+08:00",
  "seoTitle": "Go Web 开发资料下载与学习指南",
  "seoDescription": "检索 Go、Gin、数据库与部署相关学习资料。",
  "seoKeywords": "Go,Gin,Web开发",
  "tagIds": [8, 12],
  "links": [
    {
      "url": "https://pan.quark.cn/s/demo-resource",
      "extractionCode": "1234",
      "remark": "夸克主链接",
      "sort": 10,
      "enabled": true,
      "available": true,
      "lastCheckedAt": "2026-08-18T17:30:00+08:00"
    },
    {
      "url": "https://pan.xunlei.com/s/demo-resource",
      "extractionCode": "5678",
      "remark": "迅雷备用链接",
      "sort": 20,
      "enabled": true,
      "available": true
    }
  ],
  "replaceLinks": false
}

curl -sS -X POST "$BASE_URL/panSeo/openApi/resources/upsert" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "x-token: $TOKEN" \
  --data-binary @resource.json

{
  "code": 0,
  "data": {
    "resource": {
      "ID": 101,
      "resourceKey": "partner-crawler:go-web-20260818-001",
      "source": "partner-crawler",
      "externalId": "go-web-20260818-001",
      "title": "Go Web 开发资料",
      "slug": "go-web-guide",
      "status": "published"
    },
    "created": true
  },
  "msg": "录入成功"
}

{
  "items": [
    {
      "name": "Go Web 开发资料",
      "url": "https://pan.quark.cn/s/go-web-resource",
      "extractionCode": "1234",
      "available": true,
      "lastCheckedAt": "2026-08-18T17:30:00+08:00"
    },
    {
      "name": "Go Web 开发资料",
      "url": "https://pan.xunlei.com/s/go-web-resource",
      "extractionCode": "5678",
      "available": true
    },
    {
      "source": "partner-crawler",
      "externalId": "python-course-001",
      "title": "Python 入门课程",
      "summary": "Python 基础与实战课程资料。",
      "status": "published",
      "links": [
        {
          "url": "https://pan.baidu.com/s/python-course-001",
          "extractionCode": "9abc",
          "remark": "百度网盘",
          "sort": 10,
          "enabled": true,
          "available": true
        }
      ]
    }
  ]
}

curl -sS -X POST "$BASE_URL/panSeo/openApi/resources/batch-upsert" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "x-token: $TOKEN" \
  --data-binary @batch-resources.json

{
  "code": 0,
  "data": {
    "created": 2,
    "updated": 1,
    "failed": 0,
    "errors": []
  },
  "msg": "批量录入完成"
}

{
  "code": 0,
  "data": {
    "created": 1,
    "updated": 1,
    "failed": 1,
    "errors": [
      "row 4: invalid resource status"
    ]
  },
  "msg": "批量录入完成"
}

{
  "summary": "根据资源标题整理的简短说明。",
  "contentMarkdown": "## 资源说明\n\n仅描述当前上下文能够确认的信息。",
  "seoTitle": "资源名称与检索说明",
  "seoDescription": "资源页面的克制、可验证描述。",
  "seoKeywords": "资源名称,主题关键词",
  "coverUrl": "https://images.example.com/covers/resource.webp",
  "categoryId": 3,
  "tagIds": [8, 12]
}

{
  "code": 0,
  "data": {},
  "msg": "成功"
}