首页 帮助中心 微信域名拦截检测 V2 版本接口文档

微信域名拦截检测 V2 版本接口文档

原创 置顶
蜻蜓软件
2个月前 阅读 2384
版权声明:本文为博主原创文章,遵循 CC 4.0 by-sa 版权协议,转载请附上原文出处链接和本声明。
本文链接: https://wx.horocn.com/news/jE.html

概要

名 称说 明
接口地址https://wx.horocn.com/api/v2/wxUrlCheck
返回格式JSON
请求方式GET

更新内容

  1. 提供更详细的被封原因,用户可以根据自己的情况,忽略部分错误
  2. 提供获取备案信息的功能

请求参数

名称是否必填类型说明
api_tokenstring用户的API Token,在用户中心可以查询到
req_urlstring需要检测的url或域名,例:https://www.qq.com/ 或 www.qq.com
check_typestring检查类型,用于选择使用微信域名检测还是QQ域名检测。可选值:wx、qq。默认:wx。
need_icpstring是否需要返回备案信息,取值:yes 或 no

返回参数说明

名称是否一定返回类型说明
codeinteger状态码,0表示正常,非0表示错误
msgstring提示信息
data.statusstring域名状态,取值:ok(正常)、blocked(被封)
data.err_codeinteger域名被封的原因,0(正常)、30001(页面被转码)、30002(已停止访问该网页)、30998(如需浏览,请长按网址复制后使用浏览器访问)、30999(其他未知错误)
data.err_msgstring错误说明
data.sub_err_msgstring详细的错误说明
data.icp.organizationstring主办单位名称
data.icp.serialstring网站备案/许可证号
data.icp.can_visitstring是否可以浏览该网站,用于检查该网站是否提示备案。取值:yes(正常访问)、timeout(访问超时)、dns_resolve_err(DNS 解析出错)、need_icp(网站提示需要备案)、other_err(其他未知错误)

返回结果示例

// 请求频率过快
{
    "code": 10001,
    "msg": "接口调用频率过快",
    "data": []
}

// 服务端处理请求出现异常
{
    "code": 10004,
    "msg": "系统内部错误,请重试",
    "data": []
}

// 请求成功且域名正常
{
	"code": 0,
	"msg": "OK",
	"data": {
		"status": "ok",
		"err_code": 0,
		"err_msg": "",
		"sub_err_msg": ""
	}
}

// 请求成功但域名被封
// 被封原因:已停止访问该网页 -- 网页包含侵权内容
{
	"code": 0,
	"msg": "OK",
	"data": {
		"status": "blocked",
		"err_code": 30002,
		"err_msg": "已停止访问该网页",
		"sub_err_msg": "网页包含侵权内容"
	}
}

// 请求成功但域名被封
// 被封原因:页面被转码 -- 非微信官方网页
{
	"code": 0,
	"msg": "OK",
	"data": {
		"status": "blocked",
		"err_code": 30001,
		"err_msg": "页面被转码",
		"sub_err_msg": "非微信官方网页"
	}
}


// 请求成功但域名被封,需要长按网址复制后使用浏览器访问
{
	"code": 0,
	"msg": "OK",
	"data": {
		"status": "blocked",
		"err_code": 30998,
		"err_msg": "如需浏览,请长按网址复制后使用浏览器访问",
		"sub_err_msg": ""
	}
}

// 域名正常且用户设置need_icp参数为yes,服务端返回该域名的备案信息
{
	"code": 0,
	"msg": "OK",
	"data": {
		"status": "ok",
		"err_code": 0,
		"err_msg": "",
		"sub_err_msg": "",
		"icp": {
			"organization": "深圳市腾讯计算机系统有限公司",
			"serial": "粤B2-20090059-5",
			"is_icp_ok": "yes",
			"can_visit": "timeout"
		}
	}
}