Update: /v1/sticker

Author: yyyytawa

src/api/v1/expression.md

@@ -18,21 +18,20 @@ POST /v1/expression/list
 响应体:  
 ```JSONC
 {
-  "code": 1, // 请求状态码，1为正常
+  "code": 1,
   "data": {
     "expression": [
       {
         "id": 114514,
-        "url": "expression/...", // 需要在前面加上 https://chat-img.jwznb.com/
-        "urlOriginal": "https://...", // 来源URL
-        "delFlag": 0, // 未知
+        "url": "expression/abcdef123456789abcdef123456789ab.jpg", // 需要前面加上 https://chat-img.jwznb.com/
+        "urlOriginal": "https://chat-img.jwznb.com/123456789abcdefabcf43bce54e4e242.jpg", // 来源URL
+        "delFlag": 0,
         "createTime": 114514, // 创建时间戳
-        "createBy": "123" // 创建者ID
+        "createBy": "7356666" // 创建者ID
       }
-      // ...
     ]
   },
-  "msg": "success" // 返回消息
+  "msg": "success"
 }
 ```
 
@@ -48,16 +47,13 @@ POST /v1/expression/create
 请求体:  
 ```JSONC
 {
-  "url": "https://..." // 图片URL
+  "url": "https://chat-img.jwznb.com/......" // 图片URL
 }
 ```
 
 响应体:  
 ```JSONC
-{
-  "code":1, // 请求状态码，1为正常
-  "msg":"success" // 返回消息
-}
+{"code":1,"msg":"success"}
 ```
 
 ## 删除个人表情收藏中的表情
@@ -72,17 +68,12 @@ POST /v1/expression/delete
 
 请求体:  
 ```JSONC
-{
-  "id": 114514 // 表情ID
-}
+{"id": 114514} // 要删除的表情ID
 ```
 
 响应体:  
 ```JSONC
-{
-  "code":1 ,// 请求状态码，1为正常
-  "msg":"success" // 返回消息
-}
+{"code":1,"msg":"success"}
 ```
 
 ## 置顶个人表情收藏中的表情
@@ -97,15 +88,10 @@ POST /v1/expression/topping
 
 请求体:  
 ```JSONC
-{
-"id": 114514 // 表情包ID
-}
+{"id": 114514} // 要置顶的表情ID
 ```
 
 响应体:  
 ```JSONC
-{
-  "code":1, // 请求状态码，1为正常
-  "msg":"success" // 返回消息
-}
-```
+{"code":1,"msg":"success"}
+```

src/api/v1/misc.md

@@ -7,7 +7,7 @@ title: misc
 
 ## 获取个人表情收藏
 
-get /v1/misc/configure-distribution
+GET /v1/misc/configure-distribution
 
 请求头:  
 

src/api/v1/sticker.md

@@ -7,6 +7,8 @@ title: sticker
 
 ## 获取收藏表情包
 
+POST /v1/sticker/list
+
 请求头:  
 
 |名称|必须|备注|
@@ -22,22 +24,22 @@ title: sticker
    {
     "id": 114514,
     "name": "表情包名称",
-    "createBy": "创建者ID",
-    "createTime": 创建时间戳,
-    "delFlag": 0,
-    "userCount": 使用人数(数值),
-    "hot": 0,
-    "uuid": "dddddddd-dddd-2333-1145-ddddddabcdef",
-    "updateTime": 更新时间戳,
+    "createBy": "7356666", // 创建者ID
+    "createTime": 114514, // 创建时间戳
+    "delFlag": 0, // 是否被删除
+    "userCount": 2, // 使用人数
+    "hot": 0, // 表情包热度,不知道为啥全0
+    "uuid": "dddddddd-dddd-2333-1145-ddddddabcdef", // UUID
+    "updateTime": 2333, // 更新时间戳
     "sort": 0, // 分类?我这边都是0
     "stickerItems": [
      {
       "id": 114514,
       "name": "表情名称",
-      "url": "sticker/114514abcdd444456aaaaaaaaee0d454.jpg",
+      "url": "sticker/114514abcdd444456aaaaaaaaee0d454.jpg", // 表情包URL,需要前面加上 https://chat-img.jwznb.com/
       "stickerPackId": 114514, // 所属表情包ID
-      "createBy": "创建者ID",
-      "createTime": 创建时间戳,
+      "createBy": "7356666", // 创建者ID
+      "createTime": 2333, // 更新时间戳
       "delFlag": 0
      }
     ]
@@ -47,3 +49,155 @@ title: sticker
  "msg": "success"
 }
 ```
+
+## 查看表情包详情
+
+POST /v1/sticker/detail
+
+请求头:  
+
+|名称|必须|备注|
+|-----|-----|-----|
+|token|是|无|
+
+请求体:  
+```JSON
+{
+  "id": 894 // 表情包ID
+}
+```
+
+响应体:  
+```JSON
+{
+    "code": 1,
+    "data": {
+        "stickerPack": {
+            "id": 894, // 表情包ID
+            "name": "图标梗", // 表情包名称
+            "createBy": "9120256", // 创建者
+            "createTime": 1730724963, // 创建时间(时间戳)
+            "delFlag": 0,
+            "userCount": 8, // 用户人数
+            "hot": 0, // 热度? 我这边抓到的都是0
+            "uuid": "216d7881-64ae-4409-aa0a-4f4d1a8f649d", // uuid
+            "updateTime": 1754363209, // 更新时间
+            "sort": 0, // 分类相关?
+            "stickerItems": [
+                {
+                    "id": 18951, // 表情ID
+                    "name": "汇总部分", // 表情名称
+                    "url": "sticker/4599f91519364bcc2be6718c3915d388.jpg", // 表情URL,前面需加上 https://chat-img.jwznb.com/
+                    "stickerPackId": 894, // 所属表情包ID
+                    "createBy": "9120256", // 创建者ID
+                    "createTime": 1730724991, // 创建时间
+                    "delFlag": 0
+                },
+                // ...
+            ]
+        },
+        "user": {
+            "id": 56922, // 似乎是名称ID?
+            "user_id": "9120256", // 创建者用户ID
+            "nickname": "千米", // 创建者用户名
+            "avatar_url": "https://uapis.cn/api/imgapi/bq/youshou.php" // 头像地址
+        }
+    },
+    "msg": "success"
+}
+```
+
+## 添加表情包
+
+POST /v1/sticker/add
+
+请求头:  
+
+|名称|必须|备注|
+|-----|-----|-----|
+|token|是|无|
+
+请求体:  
+```JSON
+{
+  "id": 894 // 表情包ID
+}
+```
+
+响应体:  
+```JSON
+{"code": 1,"msg": "success"}
+```
+
+## 移除收藏表情包
+
+POST /v1/sticker/remove-sticker-pack  
+
+请求头:  
+
+|名称|必须|备注|
+|-----|-----|-----|
+|token|是|无|
+
+请求体:  
+```JSON
+{
+  "id": 52 // 要移除的表情包的ID
+}
+```
+
+响应体:  
+```JSON
+{"code":1,"msg":"success"}
+```
+
+## 更改收藏表情包的排序  
+
+POST /v1/sticker/sort  
+
+请求头:  
+
+|名称|必须|备注|
+|-----|-----|-----|
+|token|是|无|
+
+请求体:  
+```JSON
+{
+  "sort": "[
+    {
+      \"id\":\"123\", // 表情包ID
+      \"sort\":\"2\" // 排序,数字越大越靠前
+    },
+    {
+      \"id\":\"456\",
+      \"sort\":\"1\"
+    },
+    // ...
+    ]"
+}
+```
+
+云湖的抽象玩意.  
+把数列转字符串发.  
+
+::: details 备注: 使用Python请求代码
+```Python
+headers = {"token": token}
+sticker = [ 
+            {
+              "id": "1","sort": "1", # 不知道为啥id前面是数值这里为啥变成了字符串,sort越大排序越靠前
+            },
+            {
+              "id": "2","sort": "2"
+            }
+          ]
+payload = {"sort": str(sticker)}
+response = httpx.post("https://chat-go.jwzhd.com/v1/sticker/sort", headers = headers, json = payload) 
+print(response.text)
+```
+:::
+响应体:  
+```JSON
+{"code":1,"msg":"success"}
+```