跳转至

端点发现方法与改进路线图

本文是 Perplexity Web API 参考的一部分——全图见 API 索引。

6. 已知未探索/待确认项

  • list_collection_threads 的排序字段与 total_threads 精确语义（观测 99 vs 顶层 27）。
  • threadAccess/access/user_permission 数值全谱（观测：threadAccess 5 常规、1 带 🔒； collection access 1；permission 4 所有者 / 2 可编辑；assets data 亦含 thread_access）。
  • list_ask_threads、list_scheduled_computer_tasks 的正确参数形态（直接 GET 400）。
  • collections/*/request-access-info、spaces/<uuid>/recurring_tasks、assets/<id>/members 响应结构。
  • 仪表盘 GraphQL 操作为何未注册（PERSISTED_QUERY_NOT_FOUND）：版本错位 or 上下文门槛， 需要时以线上网络捕获的实时哈希为准重新提取。
  • frontend_uuid vs uuid vs context_uuid 三者在 computer 线程中的分工。
  • 跨账户空间共享分叉线程（branch_of）的 API 信号字段（父线程指针/分叉标记）—— 机制已确认（§3.3 末），尚无归档实例，待首例出现时验证记录。

7. 端点发现方法：前端 bundle 静态分析（零 API 成本，2026-07-20 建立）

一次发现 147 个 /rest/ 端点，方法可复用（前端改版后重跑即可）：

  1. 页面加载的入口 _spa/assets/index.html-*.js 引 bootstrap-*.js（运行时含全部 chunk 映射）；
  2. 从 bootstrap 提取 682 个 chunk 文件名（模式 <name>-<hash8>.js），按名称筛 API 相关 （client/api/thread/collection/space/computer…）；
  3. 从公共 CDN https://pplx-next-static-public.perplexity.ai/_spa/assets/<chunk>.js 直接下载 （无需 cookie）；中枢模块：platform-core-*（API client）、spa-shell-*、spa-metadata-*；
  4. grep -o '/rest/[a-zA-Z0-9_/.$_{}-]*' 得端点清单（147 个）；
  5. chunk 同时泄露调用形态（如 export 的 format:'md' 与 file_content_64）。
  6. 另有 sourcemap：https://pplx-static-sourcemaps.perplexity.ai/_spa/assets/<chunk>.js.map（未深入）。

附录：147 个端点按类分组（与归档相关性标注）

  • thread：/rest/thread/{entry_uuid_or_slug}、/rest/thread/export★、/rest/thread/{uuid}/members、 /rest/thread/list_recent、/rest/thread/list_ask_threads、/rest/thread/list_pinned_ask_threads、 /rest/thread/list_scheduled_computer_tasks、/rest/thread/request-access-info/{uuid}
  • collections/spaces★：见 §3.3 全表（含 batch_move/batch_remove、list_user_collections、request-access-info、 recurring_tasks、pins/threads、scheduled_threads）
  • assets★：/rest/assets/{asset_id}/data、/rest/assets/{asset_id}/members、 /rest/assets/{asset_id}/published-access、/rest/assets/sites/{site_id}/publish-info
  • analytics：/rest/analytics/computer/usage、/rest/analytics/computer/usage/members （均 403 NOT_ORG_MEMBER——组织账户专用）
  • models/skills：/rest/models/config(/v2)、/rest/skills、/rest/skills/selectable、 /rest/skills/grants、/rest/skills/submissions(/source)
  • files/uploads：/rest/file-repository/*（list/download/get-file-upload-urls/delete-files…）、 /rest/files/list(/list-infinite/list-errors)、/rest/uploads/(batch_)create_upload_url(s)、 /rest/connectors/attachments/upload
  • tasks/computer：/rest/tasks/、/rest/tasks/{task_id}、/rest/tasks/shortcuts/mentions、 /rest/tasks/shortcuts/paste/{copy_token}、/rest/computer/asset、/rest/computer/menu、 /rest/computer/onboarding_cards
  • user/auth：/rest/user/settings、/rest/user/get_user_ai_profile、/rest/user/promotions、 /rest/user/site-instructions、/rest/auth/get_special_profile、/rest/visitor/*
  • billing/stripe：/rest/billing/*（credits/paypal/subscription…）、/rest/stripe/*
  • enterprise/org：/rest/enterprise/*、/rest/organizations/{id}/credit-limits*、 /rest/pplx-api/v2/enterprise-api-org
  • sse：/rest/sse/attachment_processing/subscribe、/rest/sse/index_files、 /rest/sse/perplexity_terminate、/rest/sse/related-queries/{entry_uuid}
  • verticals（与归档无关）：/rest/finance/*、/rest/sports/*、/rest/travel/hotels/{slug}、 /rest/health-assistant/*、/rest/article/{uuid_or_slug}
  • misc：/rest/pins、/rest/rate-limit/(all|status)、/rest/notifications/web-push/*、 /rest/attribution/*、/rest/homepage-widgets/upsell、/rest/ntp/upsell/、/rest/sidebar/upsell/、 /rest/incentives/comet-activation、/rest/connector-service/usage

（★ = 与归档直接相关）

8. 端点 → 工具改进路线图（2026-07-20 梳理）

已落地

端点 工具能力
collections/get_collection spaces --fetch-meta：空间所有者/成员索引
collections/list_collection_threads space-index 默认 REST 直连（含 context_uuid 双 ID 映射），浏览器渲染转为 --transport webbridge 备用
assets/<uuid>/data assets-backfill --online：失效资产新鲜签名 URL 刷新
LibraryThreadsRelayQuery 等 index/batch：全量索引与增量早停

P0 — 官方导出源（POST /rest/thread/export，md/pdf/docx 已实测）

  • ~~报告保真~~（已证伪并记录）：本端点返回整线程 markdown，不含报告正文（§3.6）； report.md 的签名 URL 链路已是官方报告源，无需更换
  • 多格式归档：报告/线程可另存 pdf/docx 版（导出端点直出，无需 pandoc 等外部工具）
  • 对账：官方线程版 markdown vs 自渲染 conversation.md 的 diff 可作为渲染器回归测试

P1 — 列表与发现

  • ~~collections/list_collection_threads 替代浏览器版 space-index~~（已落地，REST 为默认、浏览器转备用）
  • collections/list_user_collections：账户空间自动枚举（新空间发现、spaces 重建的权威清单）

P2 — 元数据与风控

  • credits/thread-usage（已探明，§3.5）：按线程归档积分用量（要 context_uuid）—— 可接入 thread.json/索引 enrich
  • rate-limit/status：批量前/中读取限额状态做自适应限频（进一步防封号）
  • file-repository/list-files：toolu_ 云工作区句柄（270 个无下载通道资产）的潜在枚举/救援路径
  • pins、models/config/v2、tasks/{id}：索引 enrich（置顶状态、模型显示名、computer 工作时长）
  • thread/<uuid>/members：线程级共享关系（配合 relations 图）

P3 — 关系与增强

  • ~~sse/related-queries/<uuid>：相关问线索，relations 图加「相关」边~~（2026-07-23 证伪： related_query 的 item uuid 非线程 uuid、推荐文本与其他线程 query 零重合，不可解析为 线程关系，见 §4 字段说明；SSE 端点价值重估，不建边）
  • 仪表盘 GraphQL（threadGroup+modes 过滤）：若哈希恢复可用，可做按模式增量的索引 （当前 PERSISTED_QUERY_NOT_FOUND，阻塞中）

不采用

  • analytics/computer/usage(/members)：403 NOT_ORG_MEMBER（组织账户专用）
  • thread/request-access-info：实测是组织加入相关，与 threadAccess 语义无关
  • billing/stripe/enterprise/finance/sports 等：与归档无关

本文档与 pplx_export/README.md（工具架构）、overview.md（系统设计）互补。