玩转curl指令—测试简单的HTTP接口-阿里云开发者社区

玩转curl指令—测试简单的HTTP接口

2024-02-22 207

版权

本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。

简介： 玩转curl指令—测试简单的HTTP接口

官网：https://curl.se/

GitHub：https://github.com/curl/curl

Doc.:https://everything.curl.dev/

昨天在测试一个HTTP接口的时候，发现是添加功能，按照Restful风格应该是POST请求，但是经常使用的curl指令，如curl http://xxxx:xxx则默认是GET请求，因此又在搜索引擎上查询curl相关请求方法的指令，发现还挺丰富的，因此今天将这部分总结成一个文章，以便后续的使用。

1 初步介绍

curl主要使用C/C++编写，是一个开源的命令行工具，用于传输使用URL语法指定的数据。

支持的网络协议：

文件、FTP、FTPS、MQTT、POP3、POP3S、RTMP、RTMPS、RTSP、SCP、SFTP、SMB、SMBS、SMTP、SMTPS、TELNET 和TFTP

支持HTTP情况：

curl 支持 SSL 证书、HTTP POST、HTTP PUT、基于 HTTP 表单的上传、代理、HTTP/2、HTTP/3、cookie、用户+密码身份验证（Basic、Plain、Digest、CRAM-MD5、SCRAM-SHA、 NTLM、Negotiate 和 Kerberos）、文件传输恢复、代理隧道等。

2 安装curl工具

2.1 Linux

# Ubuntu
apt install curl
# CentOS
yum install curl

2.2 Windows

下载：https://curl.se/windows/

下载完成后配置环境变量即可

2.3 Mac OS

brew install curl

2.4 Docker

docker run -it --rm curlimages/curl www.example.com

2.5 验证安装

3 接口环境搭建和curl的使用

3.1 接口搭建

为了方便我们本次实验就使用Spring Boot搭建Http接口吧

@RestController
@RequestMapping("/hello")
public class CurlController {
    @GetMapping("/get")
    public Object get() {
        return "This is GET Method API.";
    }
    @PostMapping("/post")
    public Object post(@RequestParam("id") Integer id, @RequestParam("name") String name) {
        return "This is POST Method API,Your name is " + name + " and id is " + id + ".";
    }
    @PutMapping("/put")
    public Object put() {
        return "This is PUT Method API.";
    }
    @PostMapping("/postJSON")
    public Object postJSON(@RequestBody String str)   {
        System.out.println(str);
        return "This is POST Method API,Your Req(JSON) is " + str + ".";
    }
    @DeleteMapping("/delete/{id}")
    public Object delete(@PathVariable("id") String id) {
        return "This is DELETE Method API,Your ID is " + id+ ".";
    }
}

3.2 curl简单使用

3.2.1 GET请求

C:\Users\sb_curl>curl http://localhost:8080/hello/get
This is GET Method API.

3.2.2 POST请求

（1）一般POST请求

C:\Users\sb_curl>curl -X POST http://localhost:8080/hello/post -d "id=1&name=zs"
This is POST Method API,Your name is zs and id is 1.

-X：代表指定请求方法
-d：代表请求的数据

（2）带JSON参数的POST请求

C:\Users\sb_curl>curl -H "Content-Type:application/json" -X POST -d '{"uid":"123"}' http://127.0.0.1:8080/hello/postJSON
This is POST Method API,Your Req(JSON) is '{uid:123}'.

-H：代表请求头

3.2.3 PUT请求

C:\Users\sb_curl>curl -X PUT http://localhost:8080/hello/put
This is PUT Method API.

3.2.4 DELETE请求

C:\Users\sb_curl>curl -X DELETE http://localhost:8080/hello/delete/1
This is DELETE Method API,Your ID is 1.

4 结语

PS:注意事项分享下

因为把String类型改成了Object类型，查了好长时间，debug了好几次都没发现正确的解决方式，最后看见之前的代码才反应过来…

OK，文章到这里就结束了，本文只分享了最常用最简单的curl的使用，日常测试HTTP接口应该够用，当然其他更复杂的操作需要读者朋友按需学习，Bye~