查询 MIME 类型与扩展名

GET/reference/mime
公开访问curl路径兼容

使用 mime-db 查询 MIME 类型和扩展名。q 可填写 application/json 或 .json 等扩展名。路径入口中的斜杠须编码为 %2F。 省略 q 时列出全部条目,并按 offset 与 limit 分页。 路径示例:/reference/mime/application%2Fjson。 访问类别:匿名 API,可携带 Token 使用独立额度

请求参数

qquery
string · 默认值:"" · 最长:100 字符
offsetquery
integer / null · 默认值:0 · 最小值:0
limitquery
integer · 默认值:50 · 最小值:1 · 最大值:200
_formatquery
响应格式为 json 或 text;_format=svg 返回 JSON。plain 是 text 的别名。未识别的值继续按 Accept 协商。
string · 可选:json、text
_colorquery
控制 text 响应的 ANSI 颜色。0、false、off、no 关闭;省略或其他值保留。
string · 可选:0、false、off、no

路径兼容入口

GET /reference/mime/{q}

将 q 的值进行 URL 编码后填入路径。

响应

application/json

{
  "type": "object",
  "properties": {
    "kind": {
      "type": "string",
      "enum": [
        "mime"
      ]
    },
    "total": {
      "type": "integer"
    },
    "offset": {
      "type": "integer"
    },
    "rows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "extensions": {
            "type": "string"
          }
        },
        "required": [
          "type",
          "extensions"
        ]
      }
    }
  },
  "required": [
    "kind",
    "total",
    "offset",
    "rows"
  ]
}

响应示例

成功响应

curl -sS 'https://oit.sh/reference/mime/.json?_format=json'
HTTP 200
content-type: application/json
content-encoding: gzip
cache-control: no-store

{
  "kind": "mime",
  "total": 1,
  "offset": 0,
  "rows": [
    {
      "type": "application/json",
      "extensions": "json, map"
    }
  ]
}

错误示例

curl -sS 'https://oit.sh/reference/mime?q=.json&offset=0&limit=-1&_format=json'
HTTP 400
content-type: application/json
content-encoding: gzip
cache-control: no-store

{
  "error": {
    "code": "INVALID_INPUT",
    "message": "参数无效",
    "issues": [
      {
        "location": "query",
        "field": "limit",
        "code": "too_small",
        "message": "数值至少为 1"
      }
    ]
  }
}

curl 访问示例

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

命令与输出

curl -sS 'https://oit.sh/reference/mime/.json?_color=0'
HTTP 200
content-type: text/plain; charset=utf-8
content-encoding: gzip
cache-control: no-store

kind: mime
total: 1
offset: 0
rows:
  - 
    type: application/json
    extensions: json, map

在线调试

Ctrl / ⌘ + Enter
curl -X GET 'https://oit.sh/reference/mime'

响应

等待请求

等待发送请求