本文将一步一步地教你怎样在 Debian 系统上采用 curl 工具调用 API 接口， 并介绍怎样处理 JSON 数据、认证和错误等问题。即使你没有任意编程基础，也能轻巧松掌握这一些知识这个。

十一、 准备工作岗位

1. 安装必不可更少的工具

不夸张地说... 在 Debian 系统上调用 API，先来看需要安装一些常用的工具：

sudo apt update && sudo apt install -y curl jq python3 python3-pip

我好了。 curl 用于发送 HTTP 申请，jq 用于格式化 JSON 数据，python3 和 pip 用于安装 Python 库。

2. 设置周边环境变量

如果 API 需要身份认证， 能够将 Token 设置为周边环境变量， 没准儿… 避免坚硬编码在脚本中：

export API_TOKEN="your_token_here"

十二、采用 GET 申请调用 API

1. 基本 GET 申请

curl -s "https:///get?name=debian&version=12" | jq '.'

2. 获取响应状态码

curl -s "https:///get?name=debian&version=12" | jq '.status_code'

十三、POST 申请发送 JSON 数据

1. 采用 curl 发送 POST 申请

示例: 
 
 
 
 
 

那必须的！ 虚假设你想向一个 API 发送数据，申请体是 JSON 格式：

json { "username": "admin", "password": "password123"}

你能够采用以下命令：

bash curl -X POST \href{https://example.com/api/users} \href{--data-binary '{\"username\":\"admin\", \"password\":\"password123\"}'} \href{-H \"Content-Type: application/json\"} -v # 注意替换 URL 和 token 如果有的话, 比如 --header "Authorization: Bearer yourtoken" 。这里加上了 -v 参数能够查看详细申请信息。 如果没有token ，就去掉那一行即可。测试的时候能够采用虚假的token ，比如 'test_token' 或空字符串 '' 。 但生产周边环境不要这样做！请确保可靠！} # 这里用双斜杠来分隔各个参数和选项。 注意URL编码问题。如果URL包含特殊字符, 需要进行转义或者用双引号包围URL。举个例子, 如果url是 `https://example.com/api/users` , 则不能用单引号; 采用双引号包围整个命令内容, 能够避免很更多问题。 如果URL包含变量, 需要用美元符号引用变量名, 举个例子 `$API_URL` 。如果url本身就是变量名, 需要用单引号包裹变量名或直接写成变量名。 命令中的参数必须要用双引号括起来才能正确解析空格和其他特殊字符。 举个例子: `curl -X POST "$API_URL" --data-binary '{"key":"value"}'`。 状态码为 200 表示成功， 其他代码表示失利或错误，举个例子400 、401 、403 、404 等等.. } # 注意: 这里有一些注释， 差不多得了... 说明了不同的选项和用法。 这一些选项包括：\href{-X POST} 指定HTTP方法,\href{-H \"Content-Type: application/json\"} 设置申请头,\href{-d '...'} 指定申请体,\href{-v} 体现详细申请信息等等.} # 注意要根据实际情况调整这一些选项的值和格式.} # 十分沉关键提示: 在实际应用中, 需要根据API的要求设置正确的headers和body内容.} # 为了方便测试和调试, 能够先手动构造一个简洁的JSON字符串来测试API有没有正常工作岗位.} # 为了简化操作, 能够将JSON字符串嵌入到脚本中而不是手动输入.}# } 拿具体情况 你能够这样编写脚本：\begin{verbatim}\#!/bin/bash # 设置API URL 和 JSON 数据 API_URL=\"https://example.com/api/users\" DATA='{ \"username\": \"admin\", \"password\": \"password123\" }' # 发送POST申请并获取响应状态码 STATUS_CODE=$ # 输出状态码并打印响应内容 echo \"状态码：$STATUS_CODE\" echo \"响应内容：\" echo $STATUS_CODE| jq \end{verbatim}\ 注意请替换 https://example.com/api/users 为实际的 API 地址；将 admin, password123 替换为你的用户名和密码；如果你的 API 需要身份验证，你需要设置合适的 headers 。

十四、 设置申请超时时间段

• 为了避免由于网络或服务器问题引起申请卡住而不返回最终还是结果是提议设置超时时间段

• 举个例子设置最较大申请时间段为 15 秒

• 示例脚本

 
shell
 curl --connect-timeout 5 --max-time 15 https:///get

十五、保存 API 返回最终还是结果是到文件

• 有时需要把 API 返回最终还是结果是保存起来

• 能够采用 curl 的 `-o` 参数

     `
`      Example:
      
shell       curl -s https:///get> result.json       
         `
`

十六、处理 HTTP 状态码

• 检查 API 申请有没有成功

• 常见的 HTTP 状态码包括：

• 200 OK
• 400 Bad Request
• 401 Unauthorized
• 403 Forbidden
• 404 Not Found

      `
`      Example:
      
shell       HTTP_CODE=$       if ; n           echo "成功"       else           echo "失利 $HTTP_CODE"       fi       
         `
`

十七、模拟用户代理

• 有些 API 会根据 User Agent 来判断客户端类型或者约束访问权限

• 能够采用 curl 的 `-A` 参数指定 User Agent 值

        `
`          Example:
            
shell             curl -A "Mozilla/5.0 ..." https:///get             
            `
`

十八、处理 HTTPS 证书错误

• 当调用 HTTPS API 时有可能会遇到证书错误

解决方法包括忽略证书验证、安装 CA 证书等。提议安装 CA Certificate 包来解决此问题！ 或者更换采用其他协议但通常不推荐！ 先确保你的系统已经更崭新了柔软件源！ 这事儿我可太有发言权了。 或者手动下载证书后添加到信赖根目录中! 举个例子: sudo apt install ca-certificates && sudo update-ca-certificates