API快速入门
先决条件:
- 基本的终端/命令行技能
PATH
环境变量支持caddy
和curl
首先启动Caddy:
caddy start
Caddy现在处于空闲状态(配置为空白)。通过curl
可以给它加上一个简单的配置:
curl localhost:2019/load \
-X POST \
-H "Content-Type: application/json" \
-d @- << EOF
{
"apps": {
"http": {
"servers": {
"hello": {
"listen": [":2015"],
"routes": [
{
"handle": [{
"handler": "static_response",
"body": "Hello, world!"
}]
}
]
}
}
}
}
}
EOF
使用Heredoc提供POST包体可能很乏味,如果你更喜欢使用文件,请将JSON保存成caddy.json
的文件,然后改用以下命令:
curl localhost:2019/load \
-X POST \
-H "Content-Type: application/json" \
-d @caddy.json
现在在浏览器中访问curl
调用:
curl localhost:2015
Hello, world!
我们还可以使用这个JSON在不同的端口上定义多个站点:
{
"apps": {
"http": {
"servers": {
"hello": {
"listen": [":2015"],
"routes": [
{
"handle": [{
"handler": "static_response",
"body": "Hello, world!"
}]
}
]
},
"bye": {
"listen": [":2016"],
"routes": [
{
"handle": [{
"handler": "static_response",
"body": "Goodbye, world!"
}]
}
]
}
}
}
}
}
更新你的 JSON,然后再次执行 API 请求。
在浏览器中尝试新的“bye”端点,或使用curl
以确保它有效:
curl localhost:2016
Goodbye, world!
当你使用完Caddy后,请务必停止它:
caddy stop
使用API还可以做更多事情,包括导出配置和对配置进行细粒度地更改(而不是更新整个内容)。请务必阅读完整的 API教程,了解如何进行具体的操作!