查询 IANA 端口与服务名

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

从 IANA 查询端口、传输协议与服务名。q 可填写端口号、协议或服务名,也可用空格组合,例如 443 tcp。 省略 q 时列出全部条目,并按 offset 与 limit 分页。 路径示例:/reference/ports/443%20tcp。 访问类别:匿名 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/ports/{q}

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

响应

application/json

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

响应示例

成功响应

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

{
  "kind": "port",
  "total": 1,
  "offset": 0,
  "rows": [
    {
      "port": "443",
      "transport": "tcp",
      "service": "https"
    }
  ]
}

错误示例

curl -sS 'https://oit.sh/reference/ports?q=443+tcp&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/ports/443%20tcp?_color=0'
HTTP 200
content-type: text/plain; charset=utf-8
content-encoding: gzip
cache-control: no-store

kind: port
total: 1
offset: 0
rows:
  - 
    port: 443
    transport: tcp
    service: https

在线调试

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

响应

等待请求

等待发送请求