解析响应

你的图床会返回点什么。Dropline 要做的是把这个「点什么」变成一条 URL。两个字段负责这件事，按顺序执行。

1. JSON path —— 从响应体里挑出一个值 → {{result}}
2. 最终链接模板 —— 可选，把它改写成你真正想要的链接

两个都在设置 → 图床 → 你的配置 → 响应下。它们适用于 multipart/form-data 和二进制引擎；S3 引擎是用 bucket 和 key 自己拼出链接的，不走 JSON path。

JSON path#

一条点号分隔的路径，指向解析后的 JSON。每一段要么是对象的键，要么是数组下标。

对于这样的响应：

{
  "status": "success",
  "data": {
    "url": "https://i.example.com/2026/abc.png",
    "thumb": "https://i.example.com/2026/abc.thumb.png"
  }
}

路径就是：

data.url

如果结果被包在数组里：

{
  "files": [
    { "url": "https://i.example.com/abc.png", "size": 20481 }
  ]
}

下标就是普通的一段：

files.0.url

除了字符串，数字也能取 —— 返回值是个纯数字 id 也能用，会被转成字符串。

响应体本身就是链接#

很多自建接口只返回一条链接，别的什么都没有：

https://files.example.com/2026/08/abc.png

这时把 JSON path 留空。Dropline 会取整个响应体，去掉首尾空白和换行，当作 {{result}}。返回空响应体的接口也该这么设，再配一个用 {{key}} 拼出来的最终链接模板。

怎么找到正确的路径#

不知道响应长什么样，最快的办法是点测试上传。失败时 Dropline 会把消息摆出来；路径取不到值时它说得很明确：

响应里找不到路径 `data.url`

再不行就用 curl 手动传一次看看：

curl -sS -F "file=@test.png" \
     -H "Authorization: Bearer $TOKEN" \
     https://your-host.example.com/api/upload | jq

最终链接模板#

可选。 留空则直接用 {{result}} —— 接口本来就返回绝对 URL 时，这是对的。

不是绝对 URL 时才填它。这里能用全部模板变量，外加 {{result}}。

相对路径 → 绝对 URL#

接口返回 2026/08/abc.png，而你的文件由 CDN 域名提供：

https://cdn.example.com/{{result}}

无视响应，直接用 key 拼#

接口什么有用的东西都没返回，但文件去哪儿了你本来就知道，因为是你的键模板决定的：

https://files.example.com/{{key}}

配一个空的 JSON path 一起用。

换个域名#

接口返回的是源站 URL，而你前面挂了 CDN。这里没有字符串替换函数，所以改为用 key 拼：

https://cdn.example.com/{{key}}

三条报错分别是什么意思#

下一页#

密钥与隐私 →