易代理API参数说明详细

本站 · 2019-11-16 常见问题 1640

1. 基础接口信息

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

请求方式：GET

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

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

以下参数名为生成链接中的查询参数；除标注外请勿手工改写 secret 与 orderId。

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

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