如何使用 Express.js 构建知乎日报 API-JavaScript中文网-JavaScript教程资源分享门户

介绍

Express.js是一个基于Node.js的Web应用框架。它提供了一组强大的特性，用于快速开发简单的Web应用程序和RESTful APIs。在此文章中，我们将学习如何使用Express.js创建一个简单的知乎日报API。

设置

我们需要安装Node.js来运行我们的Express应用程序。要获取最新版本的Node.js，请访问Node.js官方网站。

一旦安装了Node.js，我们需要使用npm（Node.js包管理器）安装Express.js。在命令提示符或终端中输入以下命令：

npm install express

这将下载并安装最新的Express.js版本。我们还需要安装以下集成请求库：

npm install request

Express.js应用程序

我们的Express.js应用程序将使用RESTful API设计。我们的API将提供以下几个资源：

主题列表（/themes） - 获取知乎日报的所有主题列表。
主题详情（/theme/:id） - 获取指定ID的主题详细信息。
最新消息（/latest） - 获取最新的知乎日报消息。
消息详情（/story/:id） - 获取指定ID的消息详细信息。

创建主题列表

我们首先需要在我们的Express应用程序中创建一个新的路由器实例。要创建一个新的路由程序，请在应用程序文件中添加以下代码：

var express = require('express');
var router = express.Router();

现在我们定义了一个新的Express路由器对象，我们可以通过以下代码定义我们的第一个接口，使它返回所有的主题：

router.get('/themes', function(req, res) {
    request('https://news-at.zhihu.com/api/4/themes', function(error, response, body) {
        res.json(JSON.parse(body));
    });
});

在这个路由方法中，我们使用了request库从知乎日报API获取所有主题列表，并通过Express响应将它们返回给客户端。我们可以通过以下代码将路由器实例导出并将其添加到我们的应用程序中：

module.exports = router;

现在我们已经为我们的Express.js应用程序创建了一个简单的路由器实例，并定义了第一个路由程序以返回主题列表。

创建主题详情

下一步，我们需要为我们的Express.js应用程序创建一个用于检索主题详细信息的新路由程序。这个路由程序需要接收一个主题ID作为参数，并在知乎日报API上请求指定ID的主题信息。

router.get('/theme/:id', function(req, res) {
    request('https://news-at.zhihu.com/api/4/theme/' + req.params.id, function(error, response, body) {
        res.json(JSON.parse(body));
    });
});

我们的新路由程序使用类似于前一个路由程序的方式使用request库来从知乎日报API检索有关指定ID的主题的详细信息。通过传递请求参数req.params.id可以访问主题ID。这个信息是通过Express URL参数传递到我们的路由程序。

现在我们已经创建了我们的第二个路由程序，并为我们的Express.js应用程序创建了一些更复杂的路由器逻辑。

创建最新消息

我们下一个将创建最新消息的路由。这是从知乎日报API检索最新的知乎日报消息的路由程序。

router.get('/latest', function(req, res) {
    request('https://news-at.zhihu.com/api/4/news/latest', function(error, response, body) {
        res.json(JSON.parse(body));
    });
});

这个新路由程序使用request库向知乎日报API请求最新的知乎日报消息，并将相应结果通过Express响应对象返回给客户端。

创建消息详情

我们的最后一个路由程序为消息详情。这个程序必须接收一个消息ID参数，用于提取指定ID的消息的详细信息。

router.get('/story/:id', function(req, res) {
    request('https://news-at.zhihu.com/api/4/news/' + req.params.id, function(error, response, body) {
        res.json(JSON.parse(body));
    });
});

我们的路由程序使用request库根据请求的消息ID从知乎日报API检索消息的详细信息，并将结果返回给客户端。

现在我们已经创建了四个路由程序：主题列表，主题详情，最新消息和消息详情。我们下面将在我们的Express.js应用程序中使用这些路由程序。

使用路由程序

为了使用我们定义的路由程序，我们首先需要在我们的应用程序中实例化Express应用程序对象。要做到这一点，我们可以在应用程序文件中添加以下代码：

var express = require('express');
var app = express();
var apiRoutes = require('./routes/api');

app.use('/api/', apiRoutes);

在这个代码片段中，我们在应用程序对象中引入了Express.js库，创建了一个新的Express应用程序对象，并向我们的应用程序添加了路由器程序。

我们将路由器文件从routes/api.js导入到我们的应用程序中，并使用app.use方法将它们添加到我们的应用程序路由列表中。我们注意到，我们使用了一个根路径为“/api/”来访问我们的API接口。这个URL是通过app.use方法中的第一个参数指定的。

跑起来

现在项目代码已经写好，我们可以直接在 node.js 中跑起来：

node app.js

现在只需要使用浏览器访问或利用Postman等工具查看 API 数据即可。

总结

我们已经学习了如何使用Express.js构建一个简单的知乎日报API。我们创建了四个不同的路由程序来获取主题列表，主题详细信息，最新消息和消息详细信息。我们还演示了如何使用路由程序实现RESTful API的设计。

在RESTful API的设计中，我们需要根据访问不同的资源来对请求进行适当的路由，这样能够使我们的API更加简洁明了。

此外，Express.js还提供了许多其他功能和特性，您可以使用它们来创建更快，更可靠和更安全的Web应用程序和API。

来源：JavaScript中文网，转载请注明来源 https://www.javascriptcn.com/post/649a948948841e989477e602