API接口

当前版本： 2.0.0
Base URLs: http://api.yilian.top
版本发布时间： 2023年11月23日

支持功能:

• 获取城市列表
• 白名单管理
• 获取余量
• 获取代理ip列表

认证方式

• Token认证：请求参数携带token (请前往官网控制平台-产品管理-直连代理，已购买的直连资源中查看token)

获取城市列表 (GET)

1. 接口地址

   http://api.yilian.top/v2/proxy/cityList?token=xxxxxxxxxxxx

2. 请求参数

3. 返回结果

返回示例

200 Response

{
  "errcode": 0,
  "errmsg": "获取城市列表成功",
  "data": [
    {
      "prov": "四川",
      "prov_code": "510000",
      "CityList": [
        {
          "city": "广汉",
          "city_code": "510600"
        },
        {
          "city": "雅安",
          "city_code": "511800"
        }
      ]
    },
    {
      "prov": "贵州",
      "prov_code": "520000",
      "CityList": [
        {
          "city": "遵义",
          "city_code": "520300"
        }
      ]
    },
    {
      "prov": "重庆",
      "prov_code": "500000",
      "CityList": [
        {
          "city": "重庆",
          "city_code": "500000"
        }
      ]
    },
    {
      "prov": "陕西",
      "prov_code": "610000",
      "CityList": [
        {
          "city": "安康",
          "city_code": "610900"
        }
      ]
    },
    {
      "prov": "福建",
      "prov_code": "350000",
      "CityList": [
        {
          "city": "三明",
          "city_code": "350400"
        },
        {
          "city": "莆田",
          "city_code": "350300"
        }
      ]
    }
  ]
}

{
    "errcode": 1,
    "errmsg": "拉取失败,请联系技术人员",
    "data": null
}

401 Response

白名单管理(GET)

1. 接口地址

   http://api.yilian.top/v2/proxy/whiteList?token=xxxxxxxxxxxx

2. 请求参数

3. 返回结果

返回示例

200 Response 添加白名单[http://api.yilian.top/v2/proxy/whiteList?token=xxxxxxxxxxxx&action=add&ip=218.89.238.124]

{
  "errcode": 0,
  "errmsg": "设置白名单成功",
  "data": "218.89.238.124"
}

{
  "errcode": 1,
  "errmsg": "已执行,请勿重复操作！",
  "data": null
}

200 Response ip是否在白名单中[http://api.yilian.top/v2/proxy/whiteList?token=xxxxxxxxxxxx&action=exist&ip=218.89.238.124]

{
    "errcode": 0,
    "errmsg": "操作成功",
    "data": true
}

200 Response 删除白名单[http://api.yilian.top/v2/proxy/whiteList?token=xxxxxxxxxxxx&action=delete&ip=218.89.238.124]

{
    "errcode": 0,
    "errmsg": "操作成功",
    "data": "218.89.238.124"
}

200 Response 列出所有白名单ip[http://api.yilian.top/v2/proxy/whiteList?token=xxxxxxxxxxxx&action=list]

{
    "errcode": 0,
    "errmsg": "操作成功",
    "data": {
        "iplist": [
            {
                "ip": "171.212.234.122",
                "netmask": "255.255.255.255"
            },
            {
                "ip": "171.212.234.121",
                "netmask": "255.255.255.255"
            }
        ],
        "page": 1,
        "total": 2
    }
}

401 Response

每日ip余量查询(GET)

1. 接口地址

   http://api.yilian.top/v2/proxy/ipRemain?token=xxxxxxxxxxxx

2. 请求参数

3. 返回结果

返回示例

200 Response

{
  "errcode": 0,
  "errmsg": "SUCCESS",
  "data": {
    "used": 292, //已使用数量
    "type": "当日限量",
    "remain": 4708, //剩余数量
    "total": 5000 //套餐总量
  }
}

401 Response

获取IP列表(GET)

1. 接口地址

   http://api.yilian.top/v2/proxy/proxies?num=1&type=1&token=xxxxxxxxxxxx

2. 接口说明

• 每个ip都有自己的有效期 expire_time/expire_timestamp，超过有效期后该ip无法正常提供服务。

3. 请求参数

4. 返回结果

返回示例

200 Response

{
  "errcode": 0,
  "errmsg": "获取ip地址成功,共2个",
  "data": [
    {
      "real_ip": "180.123.224.45",
      "ip": "180.123.224.45",
      "prov": "浙江",
      "city": "湖州",
      "isp": "电信",
      "proxy_user": "s5user",
      "proxy_pass": "s5pwd",
      "proxy_port": 10083,
      "usage": "curl -x 180.123.224.45:10083 -U s5user:s5pwd https://www.baidu.com",
      "expire_time": "2023-11-23 10:38:57",
      "expire_timestamp": 1700707137
    },
    {
      "real_ip": "220.201.86.87",
      "ip": "220.201.86.87",
      "prov": "辽宁",
      "city": "鞍山",
      "isp": "联通",
      "proxy_user": "s5user",
      "proxy_pass": "s5pwd",
      "proxy_port": 10040,
      "usage": "curl -x 220.201.86.87:10040 -U s5user:s5pwd https://www.baidu.com",
      "expire_time": "2023-11-23 10:38:57",
      "expire_timestamp": 1700707137
    }
  ]
}

{
  "errcode": 1,
  "errmsg": "单次拉取数量超过限制数:400",
  "data": null
}

simple模式[http://api.yilian.top/v2/proxy/proxies?num=1&type=1&token=xxxxxxxxxxxx&format=txt]

183.154.136.17:10018

401 Response