基本信息
接口名称:
微信域名拦截、封禁检测(v1)
请求方法:
GET
计费类型:
免费
接口文档
# 微信域名拦截检测 API 文档
基于官方接口的「域名封禁」快速查询服务
---
## 接口说明
- **用途**:检测目标域名是否被微信客户端拦截
- **特点**:零依赖、毫秒级、已实测多状态
---
## 请求地址
```
https://api.logoi.cn/api/urlcheck
```
---
## 请求方法
```
GET
```
---
## 请求参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| url | string | 是 | 待检测的完整 URL(含协议) |
---
## 响应参数
| 字段名 | 类型 | 说明 |
|--------|------|------|
| url | string | 回显被检测的 URL |
| code | int | 状态码(见下方对照表) |
| msg | string | 中文状态提示 |
| ret.title | string | WeChat原始返回标题 |
| ret.desc | string | WeChat原始返回描述 |
| check_time | string | 检测完成时间(Y-m-d H:i:s) |
---
## 状态码对照表
| code | msg | 含义 |
|------|-----|------|
| 0 | 正常 | 域名未被微信拦截 |
| -1 | 拦截 | 域名已被微信封禁 |
| -2 | 未知状态:xxx | 接口返回异常或其他状态 |
---
## 响应示例
### ① 域名正常
```json
{
"code": 200,
"message": "success",
"data": {
"url": "https://baidu.com",
"code": 0,
"msg": "正常",
"ret": {
"title": "ok",
"desc": "ok"
},
"check_time": "2025-09-11 22:00:00"
},
}
```
### ② 域名被拦截
```json
{
"code": 200,
"message": "success",
"data": {
"url": "https://vvvxxx123.com",
"code": -1,
"msg": "拦截",
"ret": {
"title": "ok",
"desc": "blocked"
},
"check_time": "2025-09-11 22:01:00"
},
}
```
---
## 调用示例
### 1. 前端(一行 JS)
```javascript
fetch('https://api.logoi.cn/api/urlcheck?url=' + encodeURIComponent('https://yourdomain.com'))
.then(r => r.json())
.then(d => {
const {code, msg} = d.data;
alert(code === 0 ? '域名正常' : '域名被微信拦截:' + msg);
});
```
### 2. 后端(一行 PHP)
```php
$json = file_get_contents('https://api.logoi.cn/api/urlcheck?url=' . urlencode('https://yourdomain.com'));
$data = json_decode($json, true)['data'] ?? [];
echo $data['msg']; // 直接输出:正常 / 拦截
```
请求参数
| 参数名 | 是否必填 | 类型 | 参数说明 | 示例值 |
|---|---|---|---|---|
| url | 否 | string | 待检测的完整 URL(含协议) | https://baidu.com/ |
请求示例
{
"url": "https:\/\/baidu.com\/"
}
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | string | 状态码 |
返回示例
{
"code": "200"
}