IP提取接口文档 - 专业HTTP代理服务API指南

发布时间：2025年09月22日
来源：星月代理 http://www.xydaili.net/
425

IP提取接口文档

高效稳定的代理IP提取API，支持多种协议和地区选择

接口地址

GET http://API.xydaili.net:2022/tools/ip.ashx

此接口用于提取代理IP，支持多种参数配置，返回格式可选择文本或JSON。

请求参数说明

参数名称	含义	是否必填	取值范围
`OrderNumber`	订单号	是	有效订单编号
`qty`	提取数量	是	1-200
`protocol`	协议类型	是	1: HTTP/HTTPS 3: SOCKS5
`area`	指定地区	否	查看城市清单表
`split`	返回格式	是	txt/json
`Cache`	IP缓存	否	0: 不缓存 1: 缓存

请求示例

http://API.xydaili.net:2022/tools/ip.ashx?OrderNumber=XD202312345&qty=10&protocol=1&split=json

将上述示例中的 OrderNumber 替换为您的实际订单号即可测试接口。

响应示例（JSON格式）

{
    "code": 200,
    "msg": "成功",
    "data": [
        {
            "ip": "218.95.112.8",
            "port": 26169,
            "prov": "江西",
            "city": "吉安",
            "isp": "中国电信",
            "expire": "2021-01-29 11:15:56"
        },
        {
            "ip": "183.162.100.12",
            "port": 32145,
            "prov": "安徽",
            "city": "阜阳",
            "isp": "中国移动",
            "expire": "2021-01-29 12:30:45"
        }
    ]
}

状态码说明

200 - 成功

请求成功，返回了所需的IP数据

400 - 参数错误

请求参数有误，请检查参数格式和取值范围

401 - 认证失败

订单号无效或已过期

403 - 权限不足

当前订单没有权限访问请求的资源

500 - 服务器错误

服务器内部错误，请稍后重试

使用建议

缓存设置： 对于频繁提取IP的场景，建议设置Cache=1以提高性能
提取数量： 根据实际需要设置提取数量，避免资源浪费
错误处理： 请正确处理API返回的错误代码，确保程序稳定性
频率限制： 请注意API调用频率限制，避免过于频繁的请求

QQ客服

微信客服

电话咨询

使用方在接受本平台服务之前，请务必仔细阅读本条款并同意本声明。使用方直接或通过各类方式间接使用本平台服务的行为，都将被视作已无条件接受本声明所涉全部内容。若使用方对本声明的任何条款有异议，请停止使用本平台提供的全部服务。

第一条
本平台仅为互联网用户提供代理服务，并不针对任何网站、软件、个人。仅提供国内网络节点，不提供境外网络节点，不能用于任何非法用途，不能访问境外封闭网站，不能跨境联网，只能用于合法的国内网络加速。

第二条
使用方以各种方式使用本平台服务的过程中，必须遵守《中华人民共和国网络安全法》之规定，如涉及以下任意一条，将判定为违规，本平台有权终止用户使用，必要时交予公安机关处理。（用户所有提取和使用IP日志保存6个月）

禁止将星月代理用于博彩、赌博游戏、"私服"、"外挂"等非法互联网出版活动。
禁止通过星月代理散布电子邮件广告、垃圾邮件、电子广告或包含反动、色情等有害信息的电子邮件。
禁止将星月代理用于任何不经网络审查或依靠技术手段成为境内获取境外非法信息的途径。
禁止将星月代理用于发部侵害他人合法权益的信息或其他有损于社会秩序、社会治安、公共道德的信息或内容及其他违反法律法规、部门规章或国家政策的内容。
禁止将星月代理用于传播违反国家规定的政治宣传或新闻信息、涉及国家秘密或安全的信息、封建迷信或淫秽、色情下流的信息或教唆犯罪的信息、违反国家民族和宗教政策的信息、妨碍互联网运行安全的信息。
禁止将星月代理用于任何破坏或试图破坏网络安全的行为（包括但不限于钓鱼，黑客，盗号，网络诈骗，网站或空间中含有或涉嫌散播：病毒、木马、恶意代码，及对其他网站、服务器进行涉嫌攻击行为如扫描、嗅探、ARP欺骗、DOS等）。

第三条
任何由于机房故障、通讯线路问题，或因政府管制而造成的暂时性关闭等不可抗力因素而导致使用方不能正常使用代理服务的情况，本平台不承担任何经济及法律责任。

第四条
本声明未涉及的问题参见国家有关法律法规，当本声明与国家法律法规冲突时，以国家法律法规为准。
对免责声明的最终解释、修改及更新权均属星月代理所有。

星月代理HTTP非常重视保护您的隐私。

为方便您登录、使用相关服务，以及为您提供更个性化的用户体验和服务，您在使用我们的服务时，我们可能会收集和使用您的相关信息。我们希望通过本隐私声明向您说明，在使用星月代理HTTP服务（统称"本服务"）时，我们如何收集、使用、储存和披露您的信息，以及我们为您提供的访问、更新和保护这些信息的方式。本隐私声明与您所使用的星月代理HTTP服务相关，希望您仔细阅读。

您使用我们的服务，即意味着您已经同意我们按照本隐私声明收集、使用、储存和披露您的相关信息，以及向您提供的保护措施。

一、声明适用范围
1.1 本隐私政策适用于星月代理HTTP所有服务。

二、信息收集范围
2.1 为完成星月代理HTTP账户的注册、管理、实名认证、申请发票信息等必要活动，您需要提交真实、合法、有效的信息，包括但不限于姓名、联系电话、联系地址、银行账户信息、工商登记信息等。

2.2 为提供持续服务和保证服务质量所需，我们在您使用本服务期间，将记录并保存您登录和使用本服务的信息，包括但不限于IP地址、浏览器的类型、访问网站、访问日期和时间、软硬件特征信息、用户标识符及网页浏览记录等。

三、信息使用
为了向您提供更加优质、便捷、安全的服务，在符合相关法律法规的前提下，我们可能将收集的信息用作以下用途：

向您提供服务。
满足您的个性化需求。
服务优化改进和开发。

四、信息披露
4.1 我们还可能因以下原因而披露您的信息：

遵守适用的法律法规等有关规定。
遵守法院判决、裁定或其他法律程序的规定。
遵守相关政府机关或其他有权机关的要求。
我们有理由确信需遵守法律法规等有关规定。
为执行相关服务协议或本隐私声明、维护社会公共利益、处理投诉/纠纷，保护我们的客户、我们或我们的关联公司、其他用户或雇员的人身和财产安全或合法权益所合理必需的用途。
经过您合法授权的情形。

如我们因上述原因而披露您的信息，我们将在遵守法律法规相关规定及本声明的基础上及时告知您。

五、信息存储
5.1 星月代理HTTP收集的有关您的信息只保存于中国大陆的服务器。
5.2 通常，我们仅在为您提供服务期间保留您的信息，保留时间不会超过满足相关使用目的所必须的时间。
但在下列情况下，且仅出于下列情况相关的目的，我们有可能需要较长时间保留您的信息或部分信息：

遵守适用的法律法规等有关规定。
遵守法院判决、裁定或其他法律程序的要求。
遵守相关政府机关或其他有权机关的要求。
我们有理由确信需遵守法律法规等有关规定。
为执行相关服务协议或本隐私声明、维护社会公共利益、处理投诉/纠纷，保护我们的客户、我们或我们的关联公司、其他用户或雇员的人身和财产安全或合法权益所合理必需的用途。

六、信息安全
6.1 我们努力保障信息安全，以防信息的丢失、不当使用、未经授权阅览或披露。

我们使用各种安全技术以保障信息的安全。
我们建立严格的管理制度和流程以保障信息的安全。
我们重视信息安全合规工作，以先进的解决方案充分保障您的信息安全。

但请您理解，由于技术的限制以及可能存在的各种恶意手段，在互联网环境下，即便竭尽所能加强安全措施，也不可能始终保证信息百分之百的安全。您需要了解，您接入我们的服务所用的系统和通讯网络，有可能因我们可控范围外的因素而出现问题。

若发生个人信息泄露等安全事件，我们会启动应急预案，阻止安全事件扩大，按照《国家网络安全事件应急预案》等有关规定及时上报，并以发送短信、推送通知、公告等形式告知您相关情况，并向您给出安全建议。

6.2 为更有效的保障您的信息安全，我们也希望您能够加强自我保护意识。我们仅在星月代理HTTP直接导致您个人信息泄露的范围内承担责任，因此，请您妥善保管您的账号及密码信息，避免您的个人信息泄露。星月代理HTTP账户有安全保护功能，但您也需要妥善保护自己的个人信息，除非您判断认为必要的情形下，不向任何第三人提供您的账号密码等个人信息。