检测指定域名是否被GFW封锁。
检测指定域名是否被GFW封锁。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| url | string | 是 | 查询域名 | |
| source | integer | 否 | 检测次数1-5,默认1,越大越准 |
[
{
"name": "url",
"type": "string",
"required": true,
"description": "查询域名",
"example": ""
},
{
"name": "source",
"type": "integer",
"required": false,
"description": "检测次数1-5,默认1,越大越准",
"example": ""
}
]{"openapi":"3.1.1","info":{"title":"域名被墙检测","description":"检测指定域名是否被GFW封锁。","version":"1.0.0"},"paths":{"/apis/gateway?api=gfwcheck":{"get":{"summary":"域名被墙检测","description":"检测指定域名是否被GFW封锁。","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"查询域名"},{"name":"source","in":"query","required":false,"schema":{"type":"integer"},"description":"检测次数1-5,默认1,越大越准"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"域名被墙检测","description":"检测指定域名是否被GFW封锁。","parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"},"description":"查询域名"},{"name":"source","in":"query","required":false,"schema":{"type":"integer"},"description":"检测次数1-5,默认1,越大越准"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"https://api.souxiaocha.com","description":"当前访问入口(https)"}]}
{"success":true,"data":{"msg":"域名正常","statu":"true","url":"https:\/\/lishi.com","code":"1001"},"generated_at":"2026-08-03 22:44:44"}https://api.souxiaocha.com/apis/gateway?api=gfwcheckGET https://api.souxiaocha.com/apis/gateway?api=gfwcheck apikey=你的API密钥&url=请填写url&source=请填写source
GET 参数放在查询字符串中。参数值请替换为实际有效值。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
url | string | 是 | 查询域名 | |
source | integer | 否 | 检测次数1-5,默认1,越大越准 |
{"success":true,"data":{"msg":"域名正常","statu":"true","url":"https:\/\/lishi.com","code":"1001"},"generated_at":"2026-08-03 22:44:44"}检测指定域名是否被GFW封锁。
https://api.souxiaocha.com/apis/gateway?api=gfwcheck
GET / POST(业务参数 GET 通过 URL 传递,POST 支持表单或 JSON)
调用需携带平台密钥(用户中心「令牌管理」获取,SK- 开头):
key=SK-你的密钥X-API-Key: SK-你的密钥| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| url | string | 是 | 查询域名 |
| source | integer | 否 | 检测次数1-5,默认1,越大越准 |
[
{"name": "url", "type": "string", "required": true, "description": "查询域名"},
{"name": "source", "type": "integer", "required": false, "description": "检测次数1-5,默认1,越大越准"}
]
成功返回示例:
{"success":true,"data":{"msg":"域名正常","statu":"true","url":"https:\/\/lishi.com","code":"1001"},"generated_at":"2026-08-03 22:44:44"}
失败返回示例:
{"success":false,"error":"missing_url","message":"请提供域名参数"}
| 参数名 | 类型 | 说明 |
|---|---|---|
| data.msg | string | 返回消息 |
| data.statu | string | "true"=正常,"false"=被墙 |
| data.url | string | 检测的URL地址 |
| data.code | string | 状态码 |
curl "https://api.souxiaocha.com/apis/gateway?api=gfwcheck?key=SK-你的密钥&url=douhao.com"
平台级错误(errcode):11001 缺少密钥 / 11002 密钥无效或已禁用 / 11005 接口禁用 / 11006 接口维护 / 11010 积分不足 / 11018 请求方式不允许。
失败时请以响应体中的 code / errcode 与 msg 判断。
2026-09-24
curl "https://api.souxiaocha.com/apis/gateway?api=gfwcheck?key=SK-你的密钥&url=douhao.com"
// 结果将在此处显示