帮助中心
API文档
获取/更改 Token

https://api.2808proxy.com/login/?username=USER&password=PWD

参数: (必填) username 用户名 (必填) password 密码

(选填) change_token 若为true, 则更换token, 若此无参数, token不会更换。

token是用户访问所有接口的令牌。 其他接口通过token进行用户认证。

建议使用HTTPS方式访问API, 避免中间人攻击造成token泄露。

返回 :

{
    "status": 0,
    "msg": null,
    "data": {
        "token": “xxxxxxx",
    }
}

若status不为0, 错误信息如msg域所示。

{
    "status": 510,
    "msg": "Invalid UserName/Password",
    "data": null
}
获取代理

https://api.2808proxy.com/proxy/get?amount=1&token=TOKEN

注意! 若没有设置过期时间, 资源必须主动释放!

参数:

(必须) amount : 提取的IP数量 (必须) token : 令牌

(选填) province : 按省份过滤 (选填) city : 按城市过滤 (选填) carrier : 按运营商过滤

(选填) expire : 过期时间(秒) (选填) restrict : 严格模式, 如果不设置此参数, 会尽量返回请求的数量, 但不保证。

{
    "status": 0,
    "msg": null,
    "data": [
        {
            "ip": "182.38.77.19",
            "id": "DOP-SD-WH-002-5",
            "s5_port": 1085,
            "https_port" : 6666
        }
    ]
}

{
    "status": 700,
    "msg": "no enough line resource",
    "data": {
        "valid": 17,    //当前总资源量
        "required": 999 //当前请求值
    }
}

{
    "status": 701,
    "msg": "line resource limit",
    "data": {
        "current": 3,   --当前占用
        "valid": 3,   --允许最大值
        "required": 1 —当前请求值
    }
}

status为0表示成功, 若为700, 说明无法获取请求的资源, data域中, valid 为当前可用的数量, required为请求的数量。 如果返回701, 说明已经达到账号限制, 请先释放掉已经占用的资源。

列出已获取代理

https://api.2808proxy.com/proxy/list?token={TOKEN}

返回 (与获取接口相同)

{
    "status": 0,
    "msg": null,
    "data": [
        {
            "ip": "140.250.91.184",
            "id": "DOP-SD-WH-002-13",
            "s5_port": 1093
        },
        {
            "ip": "182.38.77.19",
            "id": "DOP-SD-WH-002-5",
            "s5_port": 1085
        }
    ]
}
释放代理

https://api.2808proxy.com/proxy/release?id=DOP-SD-WH-001-1&token={TOKEN}

注意! 若没有设置过期时间, 资源必须主动释放!

成功

{
    "status": 0,
    "msg": null,
    "data": null
}

失败:无此接口

{
"status": 1,
"msg": "no such interface”,
"data": null
}

失败:间隔过短

{
"data": null,
"status": 1,
"msg": "release interface too often, redial after 20 seconds"
}