# 每日热点新闻 API - 调用说明文档

## 📋 目录
- [基础信息](#基础信息)
- [快速开始](#快速开始)
- [接口说明](#接口说明)
- [支持的平台](#支持的平台)
- [调用示例](#调用示例)
- [错误处理](#错误处理)
- [注意事项](#注意事项)
- [常见问题](#常见问题)

---

## 基础信息

### API 地址
```
生产环境：https://newsapi.ws4.cn/api/v1/dailynews/
```

### 接口说明
获取各大平台的热点新闻数据，包括微博热搜、百度热搜、知乎热榜等20+个平台。

### 特性
- ✅ 支持多种主流平台
- ✅ 实时更新数据
- ✅ 无需认证即可使用
- ✅ JSON 格式返回
- ✅ 支持跨平台聚合查询

---

## 快速开始

### 最简单的调用
```bash
curl "https://newsapi.ws4.cn/api/v1/dailynews/?platform=baidu"
```

### Python 快速示例
```python
import requests

response = requests.get("https://newsapi.ws4.cn/api/v1/dailynews/?platform=baidu")
data = response.json()

print(f"获取到 {len(data['data'])} 条新闻")
```

---

## 接口说明

### 请求信息
- **方法**: GET
- **Content-Type**: application/json
- **编码**: UTF-8

### 请求参数

| 参数名 | 类型 | 必填 | 说明 | 示例 |
|--------|------|------|------|------|
| platform | String | 是 | 平台代码，支持多个平台用逗号分隔 | `baidu` 或 `baidu,weibo,zhihu` |

### 返回格式

#### 成功响应
```json
{
  "status": "200",
  "data": [
    {
      "title": "新闻标题",
      "url": "新闻链接",
      "content": "新闻内容或描述",
      "source": "平台名称",
      "publish_time": "2026-01-24 11:52:52"
    }
  ],
  "msg": "success"
}
```

#### 字段说明

| 字段 | 类型 | 说明 |
|------|------|------|
| status | String | 状态码，200 表示成功 |
| data | Array | 新闻数据列表 |
| data[].title | String | 新闻标题 |
| data[].url | String | 新闻链接 |
| data[].content | String | 新闻内容或描述 |
| data[].source | String | 平台来源 |
| data[].publish_time | String | 发布时间 |
| msg | String | 响应消息 |

---

## 支持的平台

| 序号 | 平台名称 | 平台代码 | 说明 |
|------|----------|----------|------|
| 1 | 百度热搜 | `baidu` | 社会热点、娱乐、事件 |
| 2 | 少数派 | `sspai` | 科技、数码、生活方式 |
| 3 | 微博热搜 | `weibo` | 社交媒体热点 |
| 4 | 知乎热榜 | `zhihu` | 问答、深度内容 |
| 5 | 36氪 | `tskr` | 科技创业、商业资讯 |
| 6 | 吾爱破解 | `ftpojie` | 技术、软件、安全 |
| 7 | 哔哩哔哩 | `bilibili` | 视频、动漫、游戏 |
| 8 | 豆瓣 | `douban` | 书影音、文化 |
| 9 | 虎扑 | `hupu` | 体育、游戏 |
| 10 | 百度贴吧 | `tieba` | 兴趣社区 |
| 11 | 掘金 | `juejin` | 编程、技术 |
| 12 | 抖音 | `douyin` | 短视频热点 |
| 13 | V2EX | `v2ex` | 技术、编程 |
| 14 | 今日头条 | `jinritoutiao` | 新闻热点 |
| 15 | Stack Overflow | `stackoverflow` | 编程问答 |
| 16 | GitHub Trending | `github` | 开源项目 |
| 17 | Hacker News | `hackernews` | 科技新闻 |
| 18 | 新浪财经 | `sina_finance` | 财经新闻 |
| 19 | 东方财富 | `eastmoney` | 财经资讯 |
| 20 | 雪球 | `xueqiu` | 股票投资 |
| 21 | 财联社 | `cls` | 财经快讯 |
| 22 | 腾讯网 | `tenxunwang` | 综合新闻 |

---

## 调用示例

### 1. cURL

#### 获取单个平台
```bash
curl "https://newsapi.ws4.cn/api/v1/dailynews/?platform=baidu"
```

#### 获取多个平台
```bash
curl "https://newsapi.ws4.cn/api/v1/dailynews/?platform=baidu,weibo,zhihu"
```

#### 完整示例
```bash
curl -X GET "https://newsapi.ws4.cn/api/v1/dailynews/?platform=baidu" \
  -H "Content-Type: application/json"
```

---

### 2. Python

#### 使用 requests 库
```python
import requests

def get_news(platform="baidu"):
    url = "https://newsapi.ws4.cn/api/v1/dailynews/"
    params = {"platform": platform}

    try:
        response = requests.get(url, params=params)
        data = response.json()

        if data['status'] == '200':
            print(f"获取到 {len(data['data'])} 条新闻")
            return data['data']
        else:
            print(f"请求失败: {data['msg']}")
            return []
    except Exception as e:
        print(f"发生错误: {e}")
        return []

# 使用示例
news_list = get_news("baidu")
for news in news_list[:5]:
    print(f"标题: {news['title']}")
    print(f"链接: {news['url']}")
    print(f"时间: {news['publish_time']}\n")
```

#### 获取多个平台
```python
def get_multiple_news(platforms):
    platforms_str = ",".join(platforms)
    url = f"https://newsapi.ws4.cn/api/v1/dailynews/?platform={platforms_str}"

    response = requests.get(url)
    return response.json()

# 使用示例
data = get_multiple_news(["baidu", "weibo", "zhihu"])
print(f"总共获取到 {len(data['data'])} 条新闻")
```

#### 异步请求（多个平台）
```python
import asyncio
import aiohttp

async def fetch_news(session, platform):
    url = "https://newsapi.ws4.cn/api/v1/dailynews/"
    async with session.get(url, params={"platform": platform}) as response:
        return await response.json()

async def get_news_async(platforms):
    async with aiohttp.ClientSession() as session:
        tasks = [fetch_news(session, p) for p in platforms]
        results = await asyncio.gather(*tasks)
        return results

# 使用示例
import asyncio
platforms = ["baidu", "weibo", "zhihu"]
results = asyncio.run(get_news_async(platforms))

for i, result in enumerate(results):
    print(f"{platforms[i]}: {len(result['data'])} 条新闻")
```

---

### 3. JavaScript / Node.js

#### 使用 fetch（浏览器或现代 Node.js）
```javascript
async function getNews(platform = 'baidu') {
  const url = `https://newsapi.ws4.cn/api/v1/dailynews/?platform=${platform}`;

  try {
    const response = await fetch(url);
    const data = await response.json();

    if (data.status === '200') {
      console.log(`获取到 ${data.data.length} 条新闻`);
      return data.data;
    } else {
      console.log('请求失败:', data.msg);
      return [];
    }
  } catch (error) {
    console.log('发生错误:', error);
    return [];
  }
}

// 使用示例
getNews('baidu').then(newsList => {
  newsList.slice(0, 5).forEach(news => {
    console.log(`标题: ${news.title}`);
    console.log(`链接: ${news.url}\n`);
  });
});
```

#### 使用 axios
```javascript
const axios = require('axios');

async function getNews(platform) {
  try {
    const response = await axios.get('https://newsapi.ws4.cn/api/v1/dailynews/', {
      params: { platform }
    });

    console.log(`获取到 ${response.data.data.length} 条新闻`);
    return response.data.data;
  } catch (error) {
    console.error('发生错误:', error);
    return [];
  }
}

// 使用示例
getNews('baidu').then(newsList => {
  newsList.forEach((news, index) => {
    console.log(`${index + 1}. ${news.title}`);
  });
});
```

#### Node.js 使用 https 模块
```javascript
const https = require('https');

function getNews(platform, callback) {
  const url = `https://newsapi.ws4.cn/api/v1/dailynews/?platform=${platform}`;

  https.get(url, (res) => {
    let data = '';

    res.on('data', (chunk) => {
      data += chunk;
    });

    res.on('end', () => {
      try {
        const result = JSON.parse(data);
        callback(null, result);
      } catch (error) {
        callback(error, null);
      }
    });
  }).on('error', (error) => {
    callback(error, null);
  });
}

// 使用示例
getNews('baidu', (error, result) => {
  if (error) {
    console.error('请求失败:', error);
    return;
  }

  console.log(`获取到 ${result.data.length} 条新闻`);
});
```

---

### 4. Java

#### 使用 HttpURLConnection
```java
import java.io.*;
import java.net.*;
import java.util.*;

public class NewsApiClient {

    public static String getNews(String platform) {
        try {
            String url = "https://newsapi.ws4.cn/api/v1/dailynews/?platform=" + platform;
            URL urlObj = new URL(url);
            HttpURLConnection conn = (HttpURLConnection) urlObj.openConnection();

            conn.setRequestMethod("GET");
            conn.setRequestProperty("Content-Type", "application/json");

            int responseCode = conn.getResponseCode();
            BufferedReader in = new BufferedReader(
                new InputStreamReader(conn.getInputStream())
            );

            String inputLine;
            StringBuilder response = new StringBuilder();

            while ((inputLine = in.readLine()) != null) {
                response.append(inputLine);
            }
            in.close();

            return response.toString();
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }

    public static void main(String[] args) {
        String jsonResponse = getNews("baidu");
        System.out.println(jsonResponse);
    }
}
```

#### 使用 OkHttp
```java
import okhttp3.*;
import java.io.IOException;

public class NewsApi {

    private static final OkHttpClient client = new OkHttpClient();

    public static void getNews(String platform) throws IOException {
        HttpUrl url = HttpUrl.parse("https://newsapi.ws4.cn/api/v1/dailynews/")
                .newBuilder()
                .addQueryParameter("platform", platform)
                .build();

        Request request = new Request.Builder()
                .url(url)
                .get()
                .build();

        try (Response response = client.newCall(request).execute()) {
            String jsonData = response.body().string();
            System.out.println(jsonData);
        }
    }

    public static void main(String[] args) throws IOException {
        getNews("baidu");
    }
}
```

---

### 5. Go

```go
package main

import (
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

type News struct {
    Title       string `json:"title"`
    URL         string `json:"url"`
    Content     string `json:"content"`
    Source      string `json:"source"`
    PublishTime string `json:"publish_time"`
}

type Response struct {
    Status string `json:"status"`
    Data   []News `json:"data"`
    Msg    string `json:"msg"`
}

func getNews(platform string) (*Response, error) {
    url := fmt.Sprintf("https://newsapi.ws4.cn/api/v1/dailynews/?platform=%s", platform)

    resp, err := http.Get(url)
    if err != nil {
        return nil, err
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        return nil, err
    }

    var result Response
    if err := json.Unmarshal(body, &result); err != nil {
        return nil, err
    }

    return &result, nil
}

func main() {
    data, err := getNews("baidu")
    if err != nil {
        fmt.Println("Error:", err)
        return
    }

    fmt.Printf("获取到 %d 条新闻\n", len(data.Data))
    for i, news := range data.Data {
        if i >= 5 {
            break
        }
        fmt.Printf("%d. %s\n", i+1, news.Title)
    }
}
```

---

### 6. PHP

```php
<?php

function getNews($platform = 'baidu') {
    $url = 'https://newsapi.ws4.cn/api/v1/dailynews/?platform=' . $platform;

    $response = file_get_contents($url);

    if ($response === false) {
        return null;
    }

    return json_decode($response, true);
}

// 使用示例
$newsData = getNews('baidu');

if ($newsData && $newsData['status'] === '200') {
    echo "获取到 " . count($newsData['data']) . " 条新闻\n";

    foreach (array_slice($newsData['data'], 0, 5) as $news) {
        echo "标题: " . $news['title'] . "\n";
        echo "链接: " . $news['url'] . "\n\n";
    }
}
?>
```

---

### 7. Ruby

```ruby
require 'net/http'
require 'json'
require 'uri'

def get_news(platform = 'baidu')
  uri = URI.parse("https://newsapi.ws4.cn/api/v1/dailynews/?platform=#{platform}")
  response = Net::HTTP.get_response(uri)

  if response.is_a?(Net::HTTPSuccess)
    data = JSON.parse(response.body)
    return data
  else
    puts "请求失败: #{response.code}"
    return nil
  end
end

# 使用示例
result = get_news('baidu')

if result && result['status'] == '200'
  puts "获取到 #{result['data'].size} 条新闻"

  result['data'].first(5).each_with_index do |news, index|
    puts "#{index + 1}. #{news['title']}"
  end
end
```

---

## 错误处理

### 常见错误码

| 状态码 | 说明 | 解决方案 |
|--------|------|----------|
| 200 | 成功 | 正常处理数据 |
| 404 | 平台代码错误 | 检查平台代码是否正确 |
| 500 | 服务器内部错误 | 稍后重试 |

### 错误处理示例（Python）

```python
import requests
import time

def get_news_with_retry(platform, max_retries=3):
    url = "https://newsapi.ws4.cn/api/v1/dailynews/"

    for attempt in range(max_retries):
        try:
            response = requests.get(url, params={"platform": platform}, timeout=10)

            if response.status_code == 200:
                data = response.json()
                if data.get('status') == '200':
                    return data.get('data', [])
                else:
                    print(f"API返回错误: {data.get('msg')}")
                    return []
            elif response.status_code == 404:
                print(f"平台代码错误: {platform}")
                return []
            elif response.status_code == 500:
                print(f"服务器错误，第 {attempt + 1} 次重试...")
                time.sleep(2)
            else:
                print(f"未知错误: {response.status_code}")
                return []

        except requests.exceptions.Timeout:
            print(f"请求超时，第 {attempt + 1} 次重试...")
            time.sleep(2)
        except requests.exceptions.ConnectionError:
            print(f"连接错误，第 {attempt + 1} 次重试...")
            time.sleep(2)
        except Exception as e:
            print(f"发生未知错误: {e}")
            return []

    print("达到最大重试次数，请求失败")
    return []
```

---

## 注意事项

### 1. 数据时效性
- 数据实时更新，建议不要频繁请求
- 推荐缓存时间：5-10 分钟
- 不同平台更新频率不同

### 2. 请求频率限制
- 目前没有明确的速率限制
- 建议合理使用，避免过度请求
- 生产环境建议加入请求队列

### 3. 数据准确性
- 数据仅供参考，不应作为新闻的主要来源
- 建议与官方平台数据交叉验证

### 4. 合法使用
- API 仅供合法使用
- 任何非法使用均不受支持
- 用户需自行承担使用责任

### 5. HTTPS 要求
- 必须使用 HTTPS 协议
- HTTP 请求可能会被拒绝

---

## 常见问题

### Q1: 如何获取多个平台的数据？
**A**: 使用逗号分隔多个平台代码
```bash
curl "https://newsapi.ws4.cn/api/v1/dailynews/?platform=baidu,weibo,zhihu"
```

### Q2: 数据多久更新一次？
**A**: 不同平台更新频率不同，一般为 30 分钟到 2 小时不等。建议缓存数据，避免频繁请求。

### Q3: 是否需要 API 密钥？
**A**: 目前不需要，接口可以直接调用。

### Q4: 支持哪些编程语言？
**A**: 支持所有支持 HTTP 请求的编程语言，本文档提供了 Python、JavaScript、Java、Go、PHP、Ruby 等示例。

### Q5: 接口限流吗？
**A**: 目前没有明确的限流策略，但建议合理使用。

### Q6: 如何处理中文编码？
**A**: 接口返回的是 UTF-8 编码的 JSON，大多数现代语言都能自动处理。如果遇到乱码，请确保使用 UTF-8 解码。

### Q7: 如何获取新闻的详细内容？
**A**: API 只返回标题和链接，详细内容需要访问链接页面获取。

### Q8: 数据可以商用吗？
**A**: 数据来源于各公开平台，使用时请遵守各平台的使用协议和相关法律法规。

---

## 技术支持

- **API 文档**: https://newsapi.ws4.cn/docs
- **健康检查**: https://newsapi.ws4.cn/health

---

## 更新日志

| 日期 | 版本 | 说明 |
|------|------|------|
| 2026-01-24 | 1.0.0 | 初始版本，支持 20+ 个平台 |

---

**免责声明**: 本 API 提供的信息仅供参考，使用者应从其他平台验证信息的准确性和时效性。