使用newsapi-go构建Golang NewsAPI客户端

newsapi-go是一个用于访问NewsAPI的Golang客户端库，它简化了与NewsAPI的交互过程。下面我将介绍如何使用这个库来获取新闻数据。

安装

首先，你需要安装newsapi-go库：

go get github.com/jellydator/newsapi-go

基本用法

1. 初始化客户端

package main

import (
	"fmt"
	"log"
	"os"

	"github.com/jellydator/newsapi-go"
)

func main() {
	// 从环境变量获取API密钥
	apiKey := os.Getenv("NEWS_API_KEY")
	if apiKey == "" {
		log.Fatal("NEWS_API_KEY environment variable not set")
	}

	// 创建NewsAPI客户端
	client := newsapi.NewClient(apiKey, nil)
	
	// 设置其他可选参数
	// client.SetHTTPClient(&http.Client{Timeout: 10 * time.Second})
}

2. 获取头条新闻

func getTopHeadlines(client *newsapi.Client) {
	// 设置查询参数
	opts := &newsapi.TopHeadlinesOptions{
		Country: "us",
		Category: "technology",
		PageSize: 5,
	}

	// 获取头条新闻
	results, err := client.GetTopHeadlines(opts)
	if err != nil {
		log.Fatalf("Error getting top headlines: %v", err)
	}

	// 打印结果
	fmt.Println("Total Results:", results.TotalResults)
	for _, article := range results.Articles {
		fmt.Println("---")
		fmt.Println("Title:", article.Title)
		fmt.Println("Source:", article.Source.Name)
		fmt.Println("URL:", article.URL)
		fmt.Println("PublishedAt:", article.PublishedAt)
	}
}

3. 获取所有新闻

func getAllNews(client *newsapi.Client) {
	// 设置查询参数
	opts := &newsapi.EverythingOptions{
		Q: "golang",
		Language: "en",
		SortBy: "publishedAt",
		PageSize: 3,
	}

	// 获取所有匹配新闻
	results, err := client.GetEverything(opts)
	if err != nil {
		log.Fatalf("Error getting all news: %v", err)
	}

	// 打印结果
	fmt.Println("Total Results:", results.TotalResults)
	for _, article := range results.Articles {
		fmt.Println("---")
		fmt.Println("Title:", article.Title)
		fmt.Println("Description:", article.Description)
		fmt.Println("URL:", article.URL)
	}
}

4. 获取可用新闻来源

func getSources(client *newsapi.Client) {
	// 设置查询参数
	opts := &newsapi.SourcesOptions{
		Category: "technology",
		Language: "en",
		Country: "us",
	}

	// 获取新闻来源
	results, err := client.GetSources(opts)
	if err != nil {
		log.Fatalf("Error getting sources: %v", err)
	}

	// 打印结果
	for _, source := range results.Sources {
		fmt.Println("---")
		fmt.Println("ID:", source.ID)
		fmt.Println("Name:", source.Name)
		fmt.Println("Description:", source.Description)
		fmt.Println("URL:", source.URL)
	}
}

高级用法

处理分页

func getPaginatedResults(client *newsapi.Client) {
	opts := &newsapi.EverythingOptions{
		Q: "artificial intelligence",
		PageSize: 20,
		Page: 2, // 获取第二页
	}

	results, err := client.GetEverything(opts)
	if err != nil {
		log.Fatal(err)
	}

	fmt.Printf("Page %d of %d\n", opts.Page, results.TotalResults/opts.PageSize+1)
}

错误处理

func handleErrors(client *newsapi.Client) {
	_, err := client.GetTopHeadlines(&newsapi.TopHeadlinesOptions{
		Country: "xx", // 无效的国家代码
	})

	if err != nil {
		switch e := err.(type) {
		case *newsapi.ErrorResponse:
			// NewsAPI返回的错误
			fmt.Printf("API Error: %s (Code: %s)\n", e.Message, e.Code)
		default:
			// 其他错误
			fmt.Printf("Unexpected error: %v\n", err)
		}
		return
	}
}

完整示例

package main

import (
	"fmt"
	"log"
	"os"

	"github.com/jellydator/newsapi-go"
)

func main() {
	apiKey := os.Getenv("NEWS_API_KEY")
	if apiKey == "" {
		log.Fatal("NEWS_API_KEY environment variable not set")
	}

	client := newsapi.NewClient(apiKey, nil)

	fmt.Println("=== Technology Headlines ===")
	getTopHeadlines(client)

	fmt.Println("\n=== Golang News ===")
	getAllNews(client)

	fmt.Println("\n=== Tech News Sources ===")
	getSources(client)
}

// 前面定义的函数放在这里...

注意事项

1. 你需要从NewsAPI官网获取API密钥
2. 免费计划有请求限制（500次/天）
3. 某些高级功能可能需要付费计划
4. 建议缓存结果以减少API调用
5. 处理错误时区分API错误和网络错误

newsapi-go库提供了简洁的接口来访问NewsAPI的所有功能，通过合理的参数组合，你可以获取各种类型的新闻数据。