API 参考
获取监控任务
读取单个监控任务及最近执行记录。
GET
/api/open/v1/monitoring/jobs/{job_id}接口概览
200monitoring:read
读取单个监控任务及最近执行记录。
认证方式
请求头使用：
Authorization: Bearer <token>这个接口所需的 scopes：
monitoring:read路径参数
job_id
string必填社区监控任务 ID。
响应
200 - application/json
id
string监控任务 ID。
object
string固定为 monitoring.job。
mode
stringsubreddit 或 search。
subreddit
stringsubreddit 模式下的目标 subreddit。
query
string | nullsearch 模式下的查询语句。
search_subreddits
string[]search 模式下限定的 subreddit 列表。
search_restrict_sr
boolean是否强制限定在 search_subreddits 内。
search_sort
string | nullsearch 模式排序方式。
search_time
string | nullsearch 模式时间范围。
sort_type
stringsubreddit 模式抓取排序方式。
limit
number单次拉取帖子数。
frequency_minutes
number监控频率（分钟）。
is_active
boolean任务是否激活。
include_comments
boolean是否抓取评论。
comment_sort
string评论排序方式。
comment_limit
number评论抓取上限。
comment_depth
number评论抓取深度。
auto_analyze
boolean是否自动分析命中帖子。
last_run_at
string | null最近一次执行时间。
next_run_at
string | null下一次预计执行时间。
created_at
string创建时间。
updated_at
string更新时间。
recent_tasks
array最近几次执行记录。
id
string监控执行任务 ID。
status
string执行状态。
progress
number执行进度。
current_step
string | null当前执行步骤。
posts_found
number本轮扫描抓到的帖子数。
posts_analyzed
number本轮完成分析的帖子数。
posts_stored
number本轮写入数据库的帖子数。
comments_found
number本轮抓到的评论数。
comments_stored
number本轮写入数据库的评论数。
comments_skipped
number本轮跳过的评论数。
error_message
string | null失败时的错误信息。
queued_at
string | null排队时间。
started_at
string | null开始执行时间。
completed_at
string | null结束时间。
created_at
string记录创建时间。
常见错误
UNAUTHORIZED
error_code缺少或无效的 Bearer Token。
FORBIDDEN
error_code当前 Token 缺少所需 scope。
RATE_LIMITED
error_code当前 Token 触发限流。
INVALID_ARGUMENT
error_code请求参数不符合 schema 约束。
NOT_FOUND
error_code目标资源不存在，或不属于当前账户。
这个页面对你有帮助吗？