概览
RedditFind Open API 面向开发者提供社区发现、社区分析、社区监控等能力。你可以从这里定位控制台、指南、API 参考 和 OpenAPI JSON,并完成标准 REST API 接入。
Default agent-facing copy stays in English on every locale.
先打开这些页面
建议先按这个顺序浏览页面,再决定下一步调用哪个接口。
进入 /dashboard?tab=open-api 创建和管理 test / live Token,并查看 Key 状态、轮转、撤销和用量。
先用示例请求跑通第一条链路,确认鉴权和请求格式都正确。
查看 Bearer Token、scope、test / live 环境和幂等请求规则。
查看统一错误结构、X-Request-Id、Retry-After 和 X-RateLimit-* 响应头。
按能力模块查找接口、字段、示例和错误码。
给 SDK 生成器、Postman 或其他 AI 工具读取标准规范。
这些页面分别解决什么问题
按任务选择接口
怎么调用这些接口
先遵守这些调用约定,再进入具体接口详情页。
查看 Bearer Token、scope、test / live 环境以及 Token 安全建议。
查看统一错误结构、请求追踪头、限流头和重试建议。
如果调用方是 AI Agent,这里说明 CLI 优先的授权闭环。
- 所有接口前缀都是 /api/open/v1,所有请求都要带 Authorization: Bearer <token>。
- 联调优先使用 rf_test_,生产流量再切 rf_live_,并把两类 Token 放在不同环境。
- 建议在真正发起业务请求前,先调用 GET /whoami 检查当前 Token 属于谁、在哪个环境、有哪些 scopes。
- 创建型接口通常遵循 POST /.../jobs -> GET /.../jobs/{job_id} -> GET /.../jobs/{job_id}/result 的异步模式。
- Key 管理走 /keys 路径:读取已有 Keys,或创建、轮转、撤销指定 Key。
- 对创建型请求优先传幂等键,避免网络重试时重复创建任务或重复计费。
- 处理错误时优先读取 error.code、error.message、error.request_id;被限流时同时查看 Retry-After 和 X-RateLimit-*。
常用接口入口
如果你已经知道目标任务,可以直接从这些接口详情页开始。