Node API快速入门
这篇文章最初发表在我的网站上。快去看看更多精彩内容吧！
本文结束时，我们将使用 Node、express和body-parser创建一个 API 。我们的 API 将有两个端点：/magic-8-ball一个返回随机的Magic 8 球答案，另一个/to-zalgo将给定的文本转换为Zalgo文本。
设置
首先，创建一个名为 `<app_name>` 的新文件夹node-api并进入该文件夹。我们需要创建一个新的 npm 包来存放我们的 API 应用。运行以下命令并填写相关信息。除入口点必须设置为 `<path>` 外，其他部分均可保留默认值app.js。
$ npm init
接下来，我们来安装express和body-parser，因为稍后会用到它们：
$ npm install express body-parser
为了运行我们的应用程序，我们需要在package.json`for` 语句中添加一个命令npm start。将此项添加到"scripts"数组中：
"scripts": {
...
"start": "node app.js"
},
快捷方式 Hello World
现在我们已经设置好了软件包，可以开始编写 Web 应用程序了。让我们在应用程序的根目录（`<script>` /、`<script>` 或 `<script> http://localhost:3200/`）返回“Hello world!”：
// Load the modules we installed
const express = require('express')
const bodyparser = require('body-parser')
// Tell express to run the webserver on port 3200
const app = express();
const port = process.env.port || 3200
// Use body-parser for unencoding API request bodies - more on this later
app.use(bodyparser.json())
app.use(bodyparser.urlencoded({ extended: false }))
app.listen(port, () => {
console.log(`running on port ${port}`)
})
// Return "Hello world" when you go to http://localhost:3200
app.get('/', (req, res) => res.send('Hello world!'))
要测试我们的应用程序，请npm start在一个终端窗口中运行以下命令，然后curl在另一个终端窗口中使用以下命令：
$ curl http://localhost:3200
Hello world!
魔法8号球的回应
我们的第一个 API 端点/magic-8-ball将返回一个 JSON 结果，格式为{"prediction": "<8-ball response>"}。我编写了一个辅助函数，用于从数组中返回一个随机项：
function randomItemFromArray(arr) {
return arr[Math.floor(Math.random() * arr.length)]
}
接下来，我们只需要让服务器维护一个包含所有可能响应的数组，随机选择一个，然后以 JSON 格式返回该响应即可：
// Return a random response for http://localhost:3200/magic-8-ball
// {"prediction": "<random_prediction>"}
app.get('/magic-8-ball', (req, res) => {
const responses = [
'It is certain.',
'It is decidedly so.',
'Without a doubt.',
'Yes - definitely.',
'You may rely on it.',
'As I see it, yes.',
'Most likely.',
'Outlook good.',
'Yes.',
'Signs point to yes.',
'Reply hazy, try again.',
'Ask again later.',
'Better not tell you now.',
'Cannot predict now.',
'Concentrate and ask again.',
"Don't count on it.",
'My reply is no.',
'My sources say no.',
'Outlook not so good.',
'Very doubtful.'
]
res.status(200).json({
prediction: randomItemFromArray(responses)
})
})
运行npm start后，我们可以使用以下命令测试几次curl：
$ curl http://localhost:3200/magic-8-ball
{"prediction":"Without a doubt."}
$ curl http://localhost:3200/magic-8-ball
{"prediction":"Yes - definitely."}
$ curl http://localhost:3200/magic-8-ball
{"prediction":"Signs point to yes."}
Zalgo文本
我们的 Zalgo 端点（/to-zalgo）功能更强大一些。用户将发送一个 POST 请求，其中包含格式为 `<message>` 的消息{"text": "your text here"}，端点将返回格式为 `<response>` 的响应{"code": 200, "original": "your text here", "zalgo": "zalgo-ified text"}。如果输入数据不正确，端点还会返回 400 HTTP 状态码错误：
// Return Zalgo-ified text for http://localhost:3200/to-zalgo
// Input: {"text": "your text here"}
// Returns: {"code": 200, "original": "your text here", "zalgo": "zalgo-ified text"}
app.post('/to-zalgo', (req, res) => {
// Return 400 if the input doesn't contain a "text" element
if (req.body.text === undefined) {
res.status(400).json({
"code": 400,
"message": "Missing 'text' argument"
})
return
}
original = req.body.text
zalgo = toZalgo(original)
res.status(200).json({
"code": 200,
"original": original,
"zalgo": zalgo
})
})
让我们用它测试几次curl。要通过 POST 请求发送数据（例如我们的 JSON 格式文本），请使用-d "data"。因为我们发送的是 JSON 格式的数据，所以我们通过 发送的请求也curl需要包含。-H "Content-Type: application/json"
（如果您想知道为什么文本看起来很奇怪，我建议您先查看一下其他Zalgo 转换器。）
$ curl -d '{"text":"Sphinx of black quartz, judge my vow"}' -H "Content-Type: application/json" http://localhost:3200/to-zalgo
{"code":200,"original":"Sphinx of black quartz, judge my vow","zalgo":"S̡̲̳͔̻ͤ̏ͦ̾̀͒̀p̰̯̐̃͒͂ͪͨͤ͘͠h̷̖̰̩̍ͯi̸̩̜͇̪͍͉̭ͨ͐̆͞ͅn̡̧̤̭͚̤̯̼̹ͪͫ́̌ͫ̇̑̋ͅx̧̻̤̄ͩ͋ͣ͂ ̥̤̩̳̠͖ͧ͡ͅö͍̮̅ͯ̋ͣf̠͎̗͕̯̈́̀͑̐͌͊̍͒́ͅ ̦̬̱͉̫͍̞ͤͯͦ͂͜b̡̼̱̊ͅl̵̻̹͇̘̒̌̊̄aͩ̏͛̋̇̅̇ͩ̀͏̘̳̲̫͕ͅc̢̛̗̱͗́̓̆̌k̡͉͉̼̾̍̒͌̀ ̡̳͈͓̞̦̞̱̥̒̌ͦ̅̃q̰̪̟̥̿̀͝ȕ̗a͓̟͍͐̓̂ͣ̀͜r̞̭̪̦̩̹̂̒̐͗̕t̺͎͛̿̽͒̑̓̆ͧz̸͖̟͓̪̻͓̝̦ͨ̕,̻͔͙̲̓̈ͮ̍ ͍̘̟̖̩͊̀̈́ͩͯ̑j̷͕̱̖̔ͧ͌u̗̱͈ͨ̄ͩͬd̜̖̖̦̺̟́̇͐͛̒̆͊ͦ͜g̎ͩͅe̪̟̦͓̥̘͙ͭ̊ͨ̓ ͔̳̒̔̈̈́̈͠ͅm̧̪̊̌y̧͂̑ͯͤ͏͔͔͓͕̮ ̸̛͎͚͇͔̭̱̱͐ͮ̐ͪ͐̊͌v̘̬̘͋̅̽̅̄̐̀o̵̤̝̯̞̪̍͞ͅw̶̠̝̦̹͔̍ͪ͐̂ͮͭ̌͟"}
{"code":200,"original":"the blood of the ancients resides within me","zalgo":"t͍̗͖͚͙͖͖̿ͪ̍h͍̘̩̤̼̞̫̜̒͟ȩ̛̺̫̖̝̰̥͋͛̎̎̈̈ ̢̼̫͈͓ͦ̿ͯb̺̖͚̤͓̲͓ͬ͊ͬ͑̅l̼̪̞̮͖̩̥͕̎ͧ̓̋̐̒ͧͯö̱̹͔̫͇́͌ͭͩ̉̆ͬ͆͠ͅô̸̶̲̫̞͔̻̝̰͓͋d̹̫̠͚͉͎ͨ͑ͯ̀ ̨̫͍̹̺̰̑͛̂̾͗ͪ̓ͅô͙̰͍͓̯͍̼̟ͭ́̽̑́͐̓f̯̥͙͈̺̮̙̙̅̌͂̓ͦ ̸͚̝̥̮̅̾t̨̟̗̟̼͔̑ͥ̊̾ͧͮ̿̿h̜̉͋ͮ͐e̪̳ͧ̾̏ ͬͤ̄̽̾̈̓͊͏̖̗̪͖͚a̢̩̖̯̹͗̊̽͢n̴̔ͥ̓͐͏̙̞̙̭̞͉c̖͕̘̗͉̠̬͂ͤͦ͋ì͕̥̱͍̗̐̅̆̓ͫe̮̩̩̮̬͕͈̾͂͒ͪ͛̇͞n̸̳̹̗͊ͦ̋ͅt͎̯̖̟̫ͯͪs͔̮͋ͧͩ͋̏ͯ̆͢ ̺̤̘̫̗̻̂r̡͚̮͇̘̻͔̉ͅĕ͔̪͖͓̯̙͙͗̂ͯ͛ͭs̵̝̘̺̠̘ͬͮi̴͖̤̟̭͚̞ͪͣd̶̛̪͈̉e͉̺̖̫ͥ̔̽̂̄͒́ͬ́́ͅṡ̵͕͟ͅ ̷̜̤̝̹̦̼͖̅ͭ̈͌͐̍ͦ͗ͅw̧̠͍̻̜͆̔ͣ͗͜i̵̶̙͉̺̦̲̅͋t̗̽͑͐ͣ̇ͣ͛ͧh̢̗͍͎̪̪̹̳̎͗̑̔̎̏͛͜i̶̱̪̺̖̻͓ͥ̿ͨ̇̅̔͗̎ͅņ̪ͬ̇ͭ̉ͬͩ͢ ̶̨̲̩̙ͦ̔̈́̄m̡̳̬̟͐e̱̩̠̙ͨ̓̇̽͑̋"}
结论
现在我们的 API 有两个端点，/magic-8-ball您/to-zalgo可以将其作为开发您自己的 Web 应用程序的起点！
以下是我们的完整版本app.js：
// Load the modules we installed
const express = require('express')
const bodyparser = require('body-parser')
var toZalgo = require('to-zalgo')
// Tell express to run the webserver on port 3200
const app = express();
const port = process.env.port || 3200
// Use body-parser for unencoding API request bodies - more on this later
app.use(bodyparser.json())
app.use(bodyparser.urlencoded({ extended: false }))
app.listen(port, () => {
console.log(`running on port ${port}`)
})
// Return "Hello world" when you go to http://localhost:3200
app.get('/', (req, res) => res.send('Hello world!'))
// Return a random response for http://localhost:3200/magic-8-ball
// Returns: {"prediction": "<random_prediction>"}
app.get('/magic-8-ball', (req, res) => {
const responses = [
'It is certain.',
'It is decidedly so.',
'Without a doubt.',
'Yes - definitely.',
'You may rely on it.',
'As I see it, yes.',
'Most likely.',
'Outlook good.',
'Yes.',
'Signs point to yes.',
'Reply hazy, try again.',
'Ask again later.',
'Better not tell you now.',
'Cannot predict now.',
'Concentrate and ask again.',
"Don't count on it.",
'My reply is no.',
'My sources say no.',
'Outlook not so good.',
'Very doubtful.'
]
res.status(200).json({
prediction: randomItemFromArray(responses)
})
})
// Return Zalgo-ified text for http://localhost:3200/to-zalgo
// Input: {"text": "your text here"}
// Returns: {"code": 200, "original": "your text here", "zalgo": "zalgo-ified text"}
app.post('/to-zalgo', (req, res) => {
// Return 400 if the input doesn't contain a "text" element
if (req.body.text === undefined) {
res.status(400).json({
"code": 400,
"message": "Missing 'text' argument"
})
return
}
original = req.body.text
zalgo = toZalgo(original)
res.status(200).json({
"code": 200,
"original": original,
"zalgo": zalgo
})
})
function randomItemFromArray(arr) {
return arr[Math.floor(Math.random() * arr.length)]
}
整个示例应用程序也可以在GitHub 代码库中找到。
文章来源：https://dev.to/nickymarino/fast-introduction-to-node-apis-5eak