# Post（帖子管理） ## **GET /api/Post/Posts** * **描述**: 获取帖子列表。 * **参数**: * `page` (integer, optional, default=1): 页码 * `pageSize` (integer, optional, default=10): 每页大小 * **响应**: 200 OK 请求示例 ``` //api/Post/Posts?page=1&pageSize=10 ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/Posts?page=1&pageSize=10", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true, "posts": [ { "id": 4333, "title": "第一个帖子", "nickname": "admin imarket", "avatar": "/images/defaultAvatar.png", "content": "这是第一篇帖子", "favoriteNums": 0, "likeNums": 0, "createdAt": "2025-01-22T14:09:56" } ] } ``` *** ## **GET /api/Post/{id}** * **描述**: 获取指定帖子详情。 * **参数**: * `id` (string, required): 帖子ID * **响应**: 200 OK 请求示例 ``` //api/Post/:id ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/:id", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true, "post": { "id": 1, "title": "第一个帖子", "content": "这是第一篇帖子", "images": [ { "id": 555, "url": "/images/17a2de2230f94dbd9ac19bd556763e22.png", "postId": 423, "createdAt": "2025-01-22T14:09:56" } ], "status": 0, "categoryID": 1, "likeNums": 0, "favoriteNms": 0, "isLiked": false, "isFavorite": false, "createdAt": "2025-01-22T14:09:56", "username": "admin", "nickname": "admin imarket", "avatar": "/images/defaultAvatar.png" } } ``` *** ## **GET /api/Post/Categories** * **描述**: 获取分类列表。 * **响应**: 200 OK 请求示例 ``` //api/Post/Categories ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/Categories", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true, "categories": [ { "id": 1, "name": "广场", "description": "这里是广场，随便说说" } ] } ``` *** ## **GET** api/Post/Categories/:id * **描述**: 根据分类 ID 获取分类信息。 * **路径参数**: * `id` (string, required): 分类的唯一标识符。 * **响应**: * **200 OK**: 返回分类信息。 * **404 Not Found**: 分类不存在。 * **请求示例**: javascript复制 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("/api/Post/Categories/12345", requestOptions) .then((response) => response.json()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` * **返回示例**: * 成功: json复制 ```json { "success": true, "category": { "id": 1, "name": "技术", "description": "与技术相关的帖子", "createdAt": "2023-10-01T12:00:00Z" } } ``` * 分类不存在: json复制 ```json { "success": false, "message": "Category not found." } ``` #### **接口逻辑说明** 1. **获取分类信息**: * 根据路径参数 `id` 调用 `postCategoriesService.GetCategoryByIdAsync(id)` 获取分类信息。 * 如果分类不存在，返回 `404 Not Found`。 2. **返回结果**: * 如果分类存在，返回 `200 OK` 和分类信息。 *** ## **GET /api/Post/CategorisedPosts** * **描述**: 获取指定分类的帖子。 * **参数**: * `categoryId` (string, required): 分类ID * `page` (integer, optional, default=1): 页码 * `pageSize` (integer, optional, default=10): 每页大小 * **响应**: 200 OK 请求示例 ``` //api/Post/CategorisedPosts?categoryId=&page=1&pageSize=10 ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/CategorisedPosts?categoryId=&page=1&pageSize=10", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true, "posts": [ { "id": 1, "title": "第一个帖子", "nickname": "admin imarket", "avatar": "/images/defaultAvatar.png", "content": "这是第一篇帖子", "favoriteNums": 0, "likeNums": 0, "createdAt": "2025-01-22T14:09:56" } ] } ``` *** ## **POST /api/Post/Create** * **描述**: 创建帖子。 * **请求体**: * `application/json`: `CreatePostRequest` 对象 * `text/json`: `CreatePostRequest` 对象 * `application/*+json`: `CreatePostRequest` 对象 * **响应**: 200 OK 请求示例 ```json { "categoryId": "", "content": "", "title": "", "images": [ "", "" ] } ``` 示例代码 {% hint style="info" %} images参数为调用图片上传接口获得的url组成的字符串数组（可为空） {% endhint %} **详情查看图片上传api页面** {% content-ref url="/pages/v5knEqYZ4iDNyOYR5zhA" %} [Image（图片管理）](/imarket/api/image-tu-pian-guan-li.md) {% endcontent-ref %} ```javascript const myHeaders = new Headers(); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Authorization", ""); const raw = JSON.stringify({ "categoryId": "", "content": "", "title": "", "images": [ "", "" ] }); const requestOptions = { method: "POST", headers: myHeaders, body: raw, redirect: "follow" }; fetch("//api/Post/Create", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true } ``` *** ## **GET /api/Post/Delete** * **描述**: 删除帖子。 * **参数**: * `postId` (string, required): 帖子ID * **响应**: 200 OK 请求示例 ``` //api/Post/Delete?postId= ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/Delete?postId=", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true } ``` *** ## **GET /api/Post/Finish** * **描述**: 标记帖子为完成。 * **参数**: * `postId` (string, required): 帖子ID * **响应**: 200 OK 请求示例 ``` //api/Post/Finish?postId= ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/Finish?postId=", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true } ``` *** ## **GET /api/Post/Favorite** * **描述**: 收藏帖子。 * **参数**: * `postId` (string, required): 帖子ID * **响应**: 200 OK 请求示例 ``` //api/Post/Favorite?postId= ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/Favorite?postId=", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true } ``` *** ## **GET /api/Post/Unfavorite** * **描述**: 取消收藏帖子。 * **参数**: * `postId` (string, required): 帖子ID * **响应**: 200 OK 请求示例 ``` //api/Post/Unfavorite?postId= ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/Unfavorite?postId=", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true } ``` *** ## **GET /api/Post/Like** * **描述**: 点赞帖子。 * **参数**: * `postId` (string, required): 帖子ID * **响应**: 200 OK 请求示例 ``` //api/Post/Like?postId= ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/Like?postId=", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true } ``` *** ## **GET /api/Post/Unlike** * **描述**: 取消点赞帖子。 * **参数**: * `postId` (string, required): 帖子ID * **响应**: 200 OK 请求示例 ``` //api/Post/Unlike?postId= ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/Unlike?postId=", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true } ``` *** ## **GET /api/Post/GetFavorites** * **描述**: 获取收藏的帖子列表。 * **参数**: * `page` (integer, optional, default=1): 页码 * `pageSize` (integer, optional, default=10): 每页大小 * **响应**: 200 OK 请求示例 ``` //api/Post/GetFavorites?page=1&pageSize=10 ``` 示例代码 ```javascript const myHeaders = new Headers(); myHeaders.append("Authorization", ""); const requestOptions = { method: "GET", headers: myHeaders, redirect: "follow" }; fetch("//api/Post/GetFavorites?page=1&pageSize=10", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error)); ``` 返回示例 ```json { "success": true, "favorite": [ { "postId": "2f729287-77ea-47df-97c9-341256a72252", "createdAt": "2025-01-22T16:46:59" } ] } ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://jeanhuas-organization.gitbook.io/imarket/api/post-tie-zi-guan-li.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.