首页 > API 文档

星月代理 API 文档中心

所有接口都是普通的 HTTP GET 请求，返回纯文本或 JSON。接入只要两步：在会员中心拿到订单号（OrderNumber），然后调用提取接口。下面按「快速开始 → 接口参数 → 状态码 → 配置示例」的顺序整理，遇到报错先看状态码对照表。

接口一览

接口	action 参数	用途	文档
提取 IP	`GetIP`（默认）	按数量/城市/运营商提取代理 IP	提取接口
添加白名单	`addwhite`	把调用方的出口 IP 加进白名单，免账号密码	白名单接口
查询白名单	`getwhites`	查看当前订单已授权的 IP 列表
删除白名单	`deletewhite`	移除某个已授权的 IP
接口探活	`isiplive`	返回 `ok`，用于监控接口可用性	其他接口
IP 池信息	`ipinfo`	查看各线路的缓存 IP 数、每日去重数	其他接口

30 秒先跑通一条

把下面地址里的 OrderNumber 换成你自己的订单号，用浏览器打开即可：

http://api.xydaili.net:2022/tools/ip.ashx?action=GetIP&OrderNumber=你的订单号&protocol=1&qty=1&split=\n

正常会返回一条代理，形如 113.75.1.20:51008，直接填进爬虫的代理配置即可。想要结构化数据，把 split 改成 json，返回里带 status、QTY、leftIp 等字段。

文档目录

快速开始5 分钟接入：拿订单号 → 浏览器验证 → 写进程序 → 上线前检查 提取接口（GetIP）qty、Area、Isp、split、Cache、bufferTime 等全部参数与返回字段 白名单接口添加、查询、删除白名单的调用方式与返回码 其他接口接口探活与 IP 池容量查看 状态码对照表200/401/203/206/406 等全部返回码含义与处理建议 代理配置示例Python requests、Scrapy、curl、Postman、环境变量的写法 常见问题连不上、返回空、白名单满了、用量怎么算 套餐与价格计量、去重计量、流量、包时、不限量套餐对比

相关页面

在线提取演示：图形界面直接提取，可生成现成的代理链接
帮助中心：购买流程、发票、会员特权等常见事项
套餐与价格：按业务量选择计量 / 流量 / 包时 / 不限量
资讯中心：采集实战、代理选型、封禁排查等经验文章

免费注册，领试用 IP

新用户可先领取试用 IP 验证接入流程，确认可用后再选套餐。

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账户有安全保护功能，但您也需要妥善保护自己的个人信息，除非您判断认为必要的情形下，不向任何第三人提供您的账号密码等个人信息。