本文将详细介绍如何使用接口盒子提供的免费API接口来获取网页状态码，并支持指定地域访问节点（国内、香港、美国等）。
接口简介
这个API接口允许用户获取指定网址的访问状态码（如200、404等），并可以指定不同的地域访问节点进行检测，非常适合网站监控、链接有效性检查等应用场景。
核心功能：
- 获取任意网址的HTTP状态码
- 支持国内、香港、美国等多个访问节点
- 免费使用
- 无需复杂配置，简单调用即可
接口参数
请求地址：
https://cn.apihz.cn/api/wangzhan/getcode.php
请求方式：
GET或POST
请求参数：
| 参数名称 | 参数 | 必填 | 说明 |
| 用户ID | id | 是 | 用户中心的数字ID |
| 用户KEY | key | 是 | 用户中心通讯秘钥 |
| 网址 | url | 是 | 需要检测的网址 |
| 地域 | type | 否 | 访问节点：1=国内（默认）, 2=香港, 3=美国 |
返回参数：
| 参数名称 | 参数 | 说明 |
| 状态码 | code | 200=成功, 400=错误 |
| 信息提示 | msg | 成功时返回网页状态码，错误时返回提示信息 |
调用示例
基本GET请求：
复制
https://cn.apihz.cn/api/wangzhan/getcode.php?id=88888888&key=88888888&type=1&url=www.apihz.cn
注意：示例中的ID和KEY是公共测试凭证，实际使用时请替换为您自己的用户ID和KEY
PHP调用示例：
php
复制
<?php // 用户凭证 $id = '88888888'; // 替换为您的用户ID $key = '88888888'; // 替换为您的用户KEY // 待检测的URL（注意特殊字符处理） $url = '(www.apihz.cn)'; // 如果URL中有&，需替换为@并用括号包裹 // 请求参数 $params = [ 'id' => $id, 'key' => $key, 'url' => $url, 'type' => '1' // 1=国内，2=香港，3=美国 ]; // 构建请求URL $apiUrl = 'https://cn.apihz.cn/api/wangzhan/getcode.php?' . http_build_query($params); // 发送请求 $response = file_get_contents($apiUrl); // 解析结果 $result = json_decode($response, true); // 处理结果 if ($result['code'] == 200) { echo "网站状态码: " . $result['msg']; } else { echo "请求失败: " . $result['msg']; } ?>
Python调用示例：
python
运行
复制
import requests import json # 用户凭证 id = "88888888" # 替换为您的用户ID key = "88888888" # 替换为您的用户KEY # 待检测的URL（注意特殊字符处理） url = "(www.apihz.cn)" # 如果URL中有&，需替换为@并用括号包裹 # 请求参数 params = { "id": id, "key": key, "url": url, "type": "1" # 1=国内，2=香港，3=美国 } # 发送GET请求 response = requests.get( "https://cn.apihz.cn/api/wangzhan/getcode.php", params=params ) # 解析结果 result = response.json() # 处理结果 if result["code"] == 200: print(f"网站状态码: {result['msg']}") else: print(f"请求失败: {result['msg']}")
返回结果示例
成功响应：
json
复制
{"code":200,"msg":"200"}
错误响应：
json
复制
{"code":400,"msg":"通讯秘钥错误。"}
使用注意事项
- 用户凭证：请前往接口盒子官网注册账号获取专属ID和KEY
- URL编码：如果网址包含特殊字符如
&，需替换为@并用英文括号包裹 - 频率限制：公共测试凭证共享调用频次限制，请使用个人凭证获得更高频率
- 地域选择：
type=1：国内节点（默认）type=2：香港节点type=3：美国节点
- 错误处理：建议在代码中添加重试机制和错误处理
应用场景
- 网站监控：定时检测网站可用性
- 链接检查：验证网页书签或外部链接有效性
- 地域测试：比较不同地区访问网站的响应情况
- SEO优化：监控网站页面返回状态码是否符合SEO要求
- 爬虫开发：作为爬虫的前置检查步骤
总结
接口盒子提供的网页状态码检测API简单易用，免费开放，支持多地域检测，是开发者和网站管理员的有力工具。通过本文的教程和代码示例，您可以快速集成此功能到您的应用或脚本中。
更多API接口和使用教程，请访问接口盒子官网
