首页
学习
活动
专区
圈层
工具
发布
首页
学习
活动
专区
圈层
工具
MCP广场
社区首页 >专栏 >获取网页状态码(可指定地域)免费API接口教程

获取网页状态码(可指定地域)免费API接口教程

原创
作者头像
用户9840656
发布2025-07-10 11:01:05
发布2025-07-10 11:01:05
19100
代码可运行
举报
运行总次数:0
代码可运行

本文将详细介绍如何使用接口盒子提供的免费API接口来获取网页状态码,并支持指定地域访问节点(国内、香港、美国等)。

接口简介

这个API接口允许用户获取指定网址的访问状态码(如200、404等),并可以指定不同的地域访问节点进行检测,非常适合网站监控、链接有效性检查等应用场景。

核心功能:

  • 获取任意网址的HTTP状态码
  • 支持国内、香港、美国等多个访问节点
  • 免费使用
  • 无需复杂配置,简单调用即可

接口参数

请求地址:

代码语言:javascript
代码运行次数:0
运行
复制
复制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请求:

代码语言:javascript
代码运行次数:0
运行
复制
复制https://cn.apihz.cn/api/wangzhan/getcode.php?id=88888888&key=88888888&type=1&url=www.apihz.cn

注意:示例中的ID和KEY是公共测试凭证,实际使用时请替换为您自己的用户ID和KEY

PHP调用示例:

代码语言:javascript
代码运行次数:0
运行
复制
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调用示例:

代码语言:javascript
代码运行次数:0
运行
复制
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']}")

返回结果示例

成功响应:

代码语言:javascript
代码运行次数:0
运行
复制
json复制{"code":200,"msg":"200"}

错误响应:

代码语言:javascript
代码运行次数:0
运行
复制
json复制{"code":400,"msg":"通讯秘钥错误。"}

使用注意事项

  1. 用户凭证​:请前往接口盒子官网注册账号获取专属ID和KEY
  2. URL编码​:如果网址包含特殊字符如&,需替换为@并用英文括号包裹
  3. 频率限制​:公共测试凭证共享调用频次限制,请使用个人凭证获得更高频率
  4. 地域选择​:
    • type=1:国内节点(默认)
    • type=2:香港节点
    • type=3:美国节点
  5. 错误处理​:建议在代码中添加重试机制和错误处理

应用场景

  1. 网站监控​:定时检测网站可用性
  2. 链接检查​:验证网页书签或外部链接有效性
  3. 地域测试​:比较不同地区访问网站的响应情况
  4. SEO优化​:监控网站页面返回状态码是否符合SEO要求
  5. 爬虫开发​:作为爬虫的前置检查步骤

总结

接口盒子提供的网页状态码检测API简单易用,免费开放,支持多地域检测,是开发者和网站管理员的有力工具。通过本文的教程和代码示例,您可以快速集成此功能到您的应用或脚本中。

更多API接口和使用教程,请访问接口盒子官网

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 接口简介
    • 核心功能:
  • 接口参数
    • 请求地址:
    • 请求方式:
    • 请求参数:
    • 返回参数:
  • 调用示例
    • 基本GET请求:
    • PHP调用示例:
    • Python调用示例:
  • 返回结果示例
    • 成功响应:
    • 错误响应:
  • 使用注意事项
  • 应用场景
  • 总结
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档