跳转到主要内容
POST
POST /admin/api/connectivity/test

授权

gproxy_session
string
cookie
必填

请求头

x-gproxy-admin-scope
string

Administrative scope selected by the caller.

请求体

application/json

What a connectivity test should exercise. Each variant resolves the same client chain a real call would: the credential's profile, then the provider's, then the channel's default, then the instance default.

scope
string
必填
Allowed value: "global"
proxy
any

Omitted tests saved settings; null previews inheritance at this scope.

响应

Success

What the edge looks like from here. ip and colo come from Cloudflare's trace endpoint, so ip is the address the upstream would see — which is the whole point of testing a proxy.

colo
string | null
必填

The Cloudflare edge that answered, e.g. NRT.

error
string | null
必填

Set exactly when ok is false.

ip
string | null
必填
ipv4
object | null
必填
ipv4Error
string | null
必填
ipv6
object | null
必填
ipv6Error
string | null
必填
latencyMs
integer<uint64>
必填

Measured across the whole exchange, including the body read, and reported for a failure too.

必填范围: x >= 0
ok
boolean
必填
proxySource
string
必填