提交社交关注截图

POST

/api/v1/social-follow-task/submit

用户提交社交平台关注截图信息，等待管理员审核。\n\n业务逻辑：\n1. 验证平台是否在白名单内（xiaohongshu/douyin/kuaishou/weibo）\n2. 验证任务存在且已启用\n3. 防重复提交：有待审核记录则拒绝；已通过则拒绝；被拒绝允许重新提交\n4. 创建提交记录，状态为待审核\n\n前置条件：\n- 用户已登录（JWT）\n- 截图已通过 POST /api/v1/exchange/upload/file 接口上传到OSS

请求参数

Header 参数

Body 参数application/json必填

示例

提交小红书关注截图提交抖音关注截图

{
    "task_id": 10,
    "platform": "xiaohongshu",
    "social_username": "用户昵称",
    "screenshot_url": "https://oss.example.com/exchange/data/2026/0507/user_id_123/screenshot.jpg"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

提交小红书关注截图提交抖音关注截图

curl --location 'https://web.richen8.cn/api/v1/social-follow-task/submit' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3ODAxNDI2MDUsImlhdCI6MTc3NzU1MDYwNSwianRpIjoiYWRjZDdlMjEtNDk4YS00OTYzLWEwMjktNDY1NTA1MmU3MzYyIiwidXNlcl9pZCI6MTEyfQ.59JzeJ5wViprpWtxWcp9yNB9VRXZVfYyO2Ya_enLEUc' \
--header 'Content-Type: application/json' \
--data '{
    "task_id": 10,
    "platform": "xiaohongshu",
    "social_username": "用户昵称",
    "screenshot_url": "https://oss.example.com/exchange/data/2026/0507/user_id_123/screenshot.jpg"
}'

返回响应

🟢200

application/json

提交成功

Bodyapplication/json

示例

{
    "code": 200,
    "data": {
        "id": 10,
        "message": "提交成功，等待审核"
    },
    "message": "success"
}

🟠400

🟠401

修改于 2026-05-07 01:51:23

获取榜单

获取用户提交记录