转换结构化数据格式

POST/format/convert
公开访问curl

支持 JSON、YAML、TOML、CSV 与 XML。CSV 表头和数据保存在 columns 与 rows,单元格按文本读取。XML 使用 @_ 表示属性,#text 表示文本。TOML 需要根表,数组与标量分别放入 rows 与 value。 访问类别:匿名 API,可携带 Token 使用独立额度

请求参数

_formatquery
响应格式为 json 或 text;_format=svg 返回 JSON。plain 是 text 的别名。未识别的值继续按 Accept 协商。
string · 可选:json、text
_colorquery
控制 text 响应的 ANSI 颜色。0、false、off、no 关闭;省略或其他值保留。
string · 可选:0、false、off、no

请求体

application/json
text必填
string · 最长:65536 字符
from必填
string · 可选:json、yaml、toml、csv、xml
to必填
string · 可选:json、yaml、toml、csv、xml

响应

application/json

{
  "type": "object",
  "properties": {
    "text": {
      "type": "string"
    }
  },
  "required": [
    "text"
  ]
}

响应示例

成功响应

printf '%s' '{"from":"json","to":"yaml","text":"{\"city\":\"香港\",\"count\":2}"}' | curl -sS --json @- https://oit.sh/format/convert
HTTP 200
content-type: application/json
content-encoding: gzip
cache-control: no-store

{
  "text": "city: 香港\ncount: 2\n"
}

错误示例

curl -sS --json '{}' https://oit.sh/format/convert
HTTP 400
content-type: application/json
content-encoding: gzip
cache-control: no-store

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "参数无效",
    "issues": [
      {
        "location": "body",
        "field": "text",
        "code": "invalid_type",
        "message": "需要 字符串 类型"
      },
      {
        "location": "body",
        "field": "from",
        "code": "invalid_value",
        "message": "允许值:json、yaml、toml、csv、xml"
      },
      {
        "location": "body",
        "field": "to",
        "code": "invalid_value",
        "message": "允许值:json、yaml、toml、csv、xml"
      }
    ]
  }
}

curl 访问示例

curl、wget、HTTPie 默认得到 text/plain。示例展示纯文本输出。

命令与输出

printf '%s' '{"from":"json","to":"yaml","text":"{\"city\":\"香港\",\"count\":2}"}' | curl -sS --json @- 'https://oit.sh/format/convert?_color=0&_format=text'
HTTP 200
content-type: text/plain; charset=utf-8
content-encoding: gzip
cache-control: no-store

text: city: 香港
count: 2

在线调试

必填
必填
必填
Ctrl / ⌘ + Enter
curl -X POST 'https://oit.sh/format/convert' \
  -H 'Content-Type: application/json' \
  --data-raw '{"text":"{\"city\":\"香港\",\"count\":2}","from":"json","to":"yaml"}'

响应

等待请求

等待发送请求