joke/docs/数据提交接口文档.md

笑话提交接口文档

接口地址

基础地址：http://39.104.58.51

---

提交笑话

接口 1：单条提交

POST /api/jokes/submit
Content-Type: application/json

请求示例：

curl -X POST http://39.104.58.51/api/jokes/submit \
  -H "Content-Type: application/json" \
  -d '{"title":"笑话标题","content":"笑话内容..."}'

响应示例：

{"success":true,"id":1280,"message":"已提交，ID: 1280"}

---

接口 2：批量提交

POST /api/jokes/submit/batch
Content-Type: application/json

请求示例：

curl -X POST http://39.104.58.51/api/jokes/submit/batch \
  -H "Content-Type: application/json" \
  -d '{
    "jokes": [
      {"title":"标题1","content":"内容1"},
      {"title":"标题2","content":"内容2"},
      {"title":"标题3","content":"内容3"}
    ]
  }'

响应示例：

{"success":true,"count":3,"message":"已提交 3 条笑话"}

---

编程语言示例

Python

import requests

BASE_URL = "http://39.104.58.51"

# 单条提交
def submit_joke(title, content):
    resp = requests.post(f"{BASE_URL}/api/jokes/submit", json={
        "title": title,
        "content": content
    })
    return resp.json()

# 批量提交
def submit_jokes_batch(jokes):
    resp = requests.post(f"{BASE_URL}/api/jokes/submit/batch", json={
        "jokes": jokes  # jokes 是 [{"title":..., "content":...}, ...]
    })
    return resp.json()


# 使用示例
if __name__ == "__main__":
    # 单条
    result = submit_joke("标题", "内容")

    # 批量
    jokes = [
        {"title": "笑话1", "content": "内容1"},
        {"title": "笑话2", "content": "内容2"},
        {"title": "笑话3", "content": "内容3"},
    ]
    result = submit_jokes_batch(jokes)
    print(result)

---

JavaScript / Node.js

const BASE_URL = "http://39.104.58.51";

// 单条提交
async function submitJoke(title, content) {
    const resp = await fetch(`${BASE_URL}/api/jokes/submit`, {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({ title, content })
    });
    return resp.json();
}

// 批量提交
async function submitJokesBatch(jokes) {
    const resp = await fetch(`${BASE_URL}/api/jokes/submit/batch`, {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({ jokes })
    });
    return resp.json();
}

// 使用示例
(async () => {
    // 单条
    console.log(await submitJoke("标题", "内容"));

    // 批量
    const jokes = [
        { title: "笑话1", content: "内容1" },
        { title: "笑话2", content: "内容2" },
    ];
    console.log(await submitJokesBatch(jokes));
})();

---

Java

import java.net.http.*;
import java.net.URI;
import java.nio.file.*;
import java.util.*;

public class JokeSubmit {
    static final String BASE_URL = "http://39.104.58.51";

    public static String post(String path, String body) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create(BASE_URL + path))
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();
        return client.send(request, HttpResponse.BodyHandlers.ofString()).body();
    }

    public static void main(String[] args) throws Exception {
        // 单条提交
        System.out.println(post("/api/jokes/submit",
            "{\"title\":\"标题\",\"content\":\"内容\"}"));

        // 批量提交
        String batch = """
            {"jokes":[
                {"title":"笑话1","content":"内容1"},
                {"title":"笑话2","content":"内容2"}
            ]}""";
        System.out.println(post("/api/jokes/submit/batch", batch));
    }
}

---

注意事项

1. 无需登录：此接口公开，无需认证即可提交
2. 自动审核：提交后笑话进入「待审核」状态
3. 字段说明：
   • title：笑话标题（必填）
   • content：笑话正文（必填）
4. 批量限制：建议单次不超过 100 条
5. 编码：确保使用 UTF-8 编码

---

状态码

状态码	说明
200	提交成功
400	请求格式错误
500	服务器内部错误