MasterPage

API链接在线生成
-
+
自定义分隔符(仅在选择「其他符号」时生效)
一键生成API链接 复制链接
API完整调用说明
1. 基础接口信息

请求地址:http://api3.ydaili.cn/tools/MeasureApi.ashx

请求方式:GET

认证参数为 secret(加密串,由平台生成的链接中带出)。本套餐请使用 EAPI;若填写其它 action,可能返回「API链接错误」。

2. 请求参数(与「一键生成 API 链接」一致)

以下参数名为生成链接中的查询参数;除标注外请勿手工改写 secretorderId

参数名是否必填说明
action必填固定为 EAPI,对应本页「极速 A 池」接口;与生成器输出一致。
secret必填由服务端根据帐号、订单等生成的加密串;须完整复制生成链接中的值,勿自行拼接或解码后修改。
orderId必填订单号,与订单中心及本页所选订单一致。
number必填单次提取条数;须 ≥1、不超过剩余次数,且不超过本页「单次提取数」上限(一般为 400,以订单为准)。
format必填txtjson,与本页「数据格式」一致;决定返回文本行或 JSON。
type选填与本页「IP协议」一致:1 HTTP、2 HTTPS、3 SOCKS5;未出现在链接中则由接口默认。
province选填省份编码;仅当本页展示「地区选择」且已选省时写入链接。
city选填城市编码;在已选省的前提下可选市。
isp选填与本页「运营商」一致:0 电信、3 联通;不传或空为全部。
jsonMeta选填仅当 format=json 且本页勾选了「属性信息」时追加;4 位编码规则见本页脚本注释(千位恒为 1,百/十/个位分别控制过期时间、运营商、城市是否在 JSON 中展示)。
split选填仅当 format=txt 时由生成器追加,表示行分隔:1 \n2 \r3 \r\n4 \t;选「其他符号」时为自定义分隔字符串(原样拼接在 URL 中)。
3. 返回示例 JSON

成功且 format=json 并勾选属性时的典型结构(字段是否齐全以 jsonMeta 与线路为准):

{
  "status": "success",
  "left_time": "",
  "number": 39895,
  "data": [
    {
      "ip": "119.183.96.225",
      "port": 40055,
      "province": "山东",
      "city": "日照",
      "isp": "联通",
      "expire_time": "2026-05-13 17:11:23"
    }
  ]
}

返回字段说明(成功 JSON)

字段名说明
status调用结果,成功时为字符串 success
left_time与套餐相关的剩余或时间类信息;可为空字符串 "" 或其它格式,以实际响应为准。
number数值型;常见为本次提取后的剩余可用次数等业务含义,以实际响应为准。
data代理列表数组;每项一条代理记录。
data[].ip代理 IP 地址。
data[].port代理端口,整数。
data[].province省份名称(未在 jsonMeta 中开启时可能不出现)。
data[].city城市名称(未在 jsonMeta 中开启时可能不出现)。
data[].isp运营商名称(未在 jsonMeta 中开启时可能不出现)。
data[].expire_time该 IP 过期时间字符串(未在 jsonMeta 中开启时可能不出现)。
4. 返回示例 TXT

每行一般为一条 ip:port;具体换行与分隔由链接中的 split 决定。

1.2.3.4:8080
5. 错误码说明
  • -1:缺少 orderId 等参数错误。
  • 101:number 为空。
  • 204:提取数量大于剩余数量。
  • 205:number 为空或小于 1。
  • 206:次数用完或订单过期;若为试用订单,提示文案可能与正式订单不同。
  • 207:secret 无效或校验失败。
  • 208:action 不能为空。
  • 209:secret 不能为空。
  • 301:订单不存在。
  • 302:API 订单已过期。
  • 388:参数错误。
  • 403:访问过频或黑名单/分钟限流等。
  • 500:系统异常;或 action 填写错误(既不是 eapi 也不是 call)时返回「API链接错误」。
  • 606:暂无可用IP。
  • 808:自动白名单个数已满。
  • 201:用户名不存在。
  • 202:秘钥验证失败。
  • 210(code):当前 IP 不在白名单。

若返回中出现其它数字错误码,请以响应中的文字说明为准(部分场景会做业务码映射)。