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
下载完成后配置环境变量即可
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~