200 OK
API v1build 72f6f92 · updated

HTTP 请求与响应服务

检查请求、测试响应并调试集成。

如需生成随机字符串和标识符,请试试 rand.hacks.run.

Base URL

https://200ok.hacks.run

输出

默认返回纯文本。使用 ?json 获取紧凑的 JSON,或使用 ?pretty 获取格式化的 JSON。只要参数存在,就会启用对应选项,与参数值无关。?pretty 的优先级高于 ?json。

本地运行
docker run --rm -p 3000:3000 ghcr.io/teplostanski/200ok:latest

http://localhost:3000

默认最多允许 64 层 JSON 对象或数组嵌套。如需在本地测试更深的嵌套,请将 JSON_MAX_DEPTH 设置为 1 到 512。请求体大小仍限制为 100 KiB。

docker run --rm -e JSON_MAX_DEPTH=256 -p 3000:3000 ghcr.io/teplostanski/200ok:latest

Status

HTTP 状态码参考
GETPOSTPUTPATCHDELETE

返回所选 HTTP 状态码及其原因短语。

详情

请求示例

GET

curl https://200ok.hacks.run/status/200

响应

200 OK

响应体包含请求的状态码及其原因短语,1xx 也不例外。例如:200 OK。

示例 · text/plain

200 OK

IP

/ip

输出
GET

客户端的 IP 地址(IPv4 或 IPv6)。

详情

请求示例

GET

curl https://200ok.hacks.run/ip

响应

200 OK

客户端的 IP 地址(IPv4 或 IPv6)。

示例 · text/plain

192.0.2.1

/ip/v4

输出
GET

客户端的 IPv4 地址。

详情

请求示例

GET

curl https://200ok.hacks.run/ip/v4

响应

200 OK

客户端连接地址。此示例使用文档专用 IP 地址。如果地址族与端点不匹配,纯文本响应为 unknown,JSON 响应为 null。

示例 · text/plain

192.0.2.1

/ip/v6

输出
GET

客户端的 IPv6 地址。

详情

请求示例

GET

curl https://200ok.hacks.run/ip/v6

响应

200 OK

客户端连接地址。此示例使用文档专用 IP 地址。如果地址族与端点不匹配,纯文本响应为 unknown,JSON 响应为 null。

示例 · text/plain

2001:db8::1

Echo

/echo

输出
GETPOSTPUTPATCHDELETE

返回请求方法和请求体。支持 JSON、纯文本、URL 编码的表单和二进制数据。

详情

请求示例

POST · JSON

curl https://200ok.hacks.run/echo \
  -H 'Content-Type: application/json' \
  --data-binary '{"name":"Bob"}'

POST · 纯文本

curl https://200ok.hacks.run/echo \
  -H 'Content-Type: text/plain' \
  --data-binary 'Hello!'

POST · 表单

curl https://200ok.hacks.run/echo \
  --data-urlencode 'name=Bob' \
  --data-urlencode 'age=42'

POST · 二进制文件

curl https://200ok.hacks.run/echo \
  -H 'Content-Type: application/octet-stream' \
  --data-binary '@./file.bin'

响应

200 OK

请求方法和解析后的请求体。此示例是没有请求体的 GET 请求。

示例 · text/plain

GET

null
413 Payload Too Large

请求体超过 102,400 字节(100 KiB)。

示例 · text/plain

Request body exceeds the size limit of 100 KiB
415 Unsupported Media Type

非空请求体的 Content-Type 不受支持或缺失。

示例 · text/plain

Unsupported Content-Type. Supported: application/json, text/plain, application/x-www-form-urlencoded, application/octet-stream

无效的 JSON 会返回 400。API 错误使用所选输出格式:纯文本或 JSON。

Headers

/headers

输出
GET

传入请求的标头。

详情

请求示例

自定义标头

curl https://200ok.hacks.run/headers \
  -H 'X-Test: hello'

响应

200 OK

传入请求的标头。名称和值取决于客户端。

示例 · text/plain

host:  localhost:3000

accept:  */*