luogu-api-docs

专栏 API

列出文章

请求 GET /article
参数 { category?: number; page?: number }
响应主体 application/json (LentilleDataResponse<ArticleListData>)

列出用户文章

请求 GET /api/article/find
参数 ArticleListParams
响应主体 application/json ({ articles: List<Article> })

列出创建的文章

请求 GET /article/mine
参数 { type?: "all" | "promotion"; page?: number }
响应主体 application/json (LentilleDataResponse<CreatedArticleListData>)

列出收藏的文章

请求 GET /article/favored
参数 { page?: number }
响应主体 application/json ({ favorites: List<{ time: number; article: Article }> })

获取文章

: 此处的域名为 www.luogu.com

请求 GET /article/:lid
响应主体 application/json (LentilleDataResponse<ArticleData>)

列出合集文章

请求 GET /article/collection/:id
参数 { page?: number }
响应主体 application/json (LentilleDataResponse<ArticleCollectionData>)

获取可投稿的官方合集

请求 GET /article/:lid/availableCollection
响应主体 application/json ({ collections: ArticleCollectionSummary[] })

创建文章

请求 POST /api/article/new
请求主体 application/json (EditArticleRequest)
响应主体 application/json ({ article: ArticleDetails })

编辑文章

请求 POST /api/article/edit/:lid
请求主体 application/json (EditArticleRequest)
响应主体 application/json ({ article: ArticleDetails })

删除文章

请求 POST /api/article/delete/:lid
响应主体 application/json ({ lid: string })

批量修改文章

请求 POST /api/article/batchEdit
请求主体 application/json (BatchEditArticleRequest)
响应主体 application/json ({ lids: string[] })

收藏文章

请求 POST /api/article/favor/:lid
参数 { remove?: unknown }
响应主体 application/json ({ lid: string })

赞/踩文章

:和原博客 API 不同,此处通过 URL 而非请求主体传参。

请求 POST /api/article/vote/:lid
参数 { vote: number }
响应主体 application/json ({ voted: number; upvotes: number })

申请全站推荐

请求 POST /api/article/requestPromotion/:lid
响应主体

撤回全站推荐

请求 POST /api/article/withdrawPromotion/:lid
响应主体

获取评论

请求 GET /article/:lid/replies
参数 { sort?: string; after?: number }
响应主体 application/json ({ replySlice: Comment[] })

发表评论

请求 POST /article/:lid/reply
请求主体 application/json ({ content: string })
响应主体 application/json ({ reply: Comment })

删除评论

请求 POST /article/:lid/deleteReply/:id
响应主体 application/json ({ id: number })