项目列表


默认接口url为:/api/

接口结果值采用json格式返回

如接口地址不符合本规则,在本当中有特殊说明,指明特殊接口地址


1、通用文档

code:状态码 0成功,大于0表示请求错误

data:返回的数据

message:请求返回信息

请求方式:get

接口通用参数

key         登录用key(在"账户信息"查看)

secret      登录用secret(在"账户信息"查看)

列表默认参数

page     当前页    默认第1页

size      每页显示数量   默认每页20条


返回JSON:

{

    "code": 0,

    "msg": "获取数据成功",

    "data": {

        "total": 3,                         // 共3条

        "per_page": 1,                  // 每页显示1条

        "current_page": 1,            // 当前第1页

        "last_page": 3,                // 最后页数

        "data": [                       //数据

            {

            }

        ]

    }

}

错误码

201 验证码已下发

202 号码已占用,未接到到短信

203 号码未占用,未接到到短信

400 失败,系统异常

401 失败,无效操作

403 没有数据

406 24小时内获得的新数量已达到最大数量。请联系管理员升级您的帐户级别以增加新号码的访问权限或继续获取旧号码

800 账号被封禁

802 用户名或密码错误

803 用户名和密码不能为空

902 参数不正确

903 无效的国家代码

904 无效的项目ID

905 无效的手机号码

906 手机号列表为空

907 vip_key错误

912 请勿重复操作

200408 获取号码已达到上限,请联系管理员增加更多号码

400100 该手机号没有添加黑名单

400101 此项目需要密钥,请与管理员联系

400102 指定的参数未打开,请与管理员联系

400103 secret_key错误

400906 无效系列或系列参数错误

400907 无效号码


2、api接口

2.1、getMemberInfo 获取用户消息

**请求URL:

/api/qnapi/getMemberInfo?key=***&secret=***

参数:

参数名 必选 类型 说明

key 是 string 登录用key(在"账户信息"查看)

secret 是 string 登录用secret(在"账户信息"查看)


返回示例JSON

{

    "code": 0,

    "msg": "请求成功!",

    "data": {

        "username": "dayu6",              // 账号

        "nickname": "",                         // 昵称

        "mobile": "17778188475",            //手机号码

        "email": "2222@163.com",            // 邮箱

        "alipay": "1ad123",            // 阿里账号

        "score": 140,                           // 剩余积分

        "create_time": "2021-12-31 15:14:43"        // 注册时间

    }

}


2.2、getMobile 获取手机号码

**请求URL:

/api/qnapi/getMobile?key=***&secret=***&service=***&country=***operation=***

参数: 

参数名 必选 类型 说明

key 是 string 登录用key(在"账户信息"查看)

secret 是 string 登录用secret(在"账户信息"查看)

service 是 string 服务项目标识ID(在左侧项目列表查看,例如:Telegram的ID为tg)

country 是 int 国家标识ID(在左侧项目列表查看,例如:Telegram的越南的ID为10)

operation 是运营商标识,登录网站收藏项目之后,可查看支持的运营商

返回示例

{

    "code": 0,

    "msg": "",

    "data": {

        "message_id": "20",                        // 消息id

        "source_id": 1,                                // 源id

        "project_id": "1448",                       //  项目id 

        "country_id": "",                             // 国家id

"operation_id": 0,                        //运营商ID

        "mobile": "+542241585546",           // 手机号码

        "addon": ""                                   // 附近数据

    }

}


备注 


·通用字段见通用字段说明


2.3、getMessage 获取验证码

**请求URL:

/api/qnapi/getMessage?key=***&secret=***&message_id=***

参数: 

参数名 必选 类型 说明

key 是 string 登录用key

secret 是 string 登录用secret

message_id 是 int 消息id

返回示例

{

    "code": 0,

    "msg": "请求成功!",

    "data": {

        "msg": "1242",          // 短信消息

        "more": [],                 //重获取短信情况下的另外的短信

        "addon": ""

    },

    is_show:0

}


2.3.1、reGetMessage 重新获取验证码

在获取一条验证码后,若在该验证码无法使用的情况下,使用本接口发起重新获取验证码,注意:发起之后,获取验证码还是使用接口:/qnapi/getMessage)

**请求URL:

/api/qnapi/reGetMessage?key=***&secret=***&message_id=***

参数: 

参数名 必选 类型 说明

key 是 string 登录用key

secret 是 string 登录用secret

message_id 是 int 消息id

返回示例

{

    "code": 0,

    "msg": "NO_NUMBERS",

    "data": {

        "message_id": 855

    }

}


2.4、releaseMobile 释放手机号

**请求URL:

/api/qnapi/releaseMobile?key=***&secret=***&message_id=***

参数: 

参数名 必选 类型 说明

key 是 string 登录用key

secret 是 string 登录用secret

message_id 是 int 消息id

返回示例

{

    "code": 0,

    "msg": "Success",

    "data": 1           

}


2.5、addBlack 添加黑名单(此接口已过期)

**请求URL:

/api/qnapi/addBlack?key=***&secret=***&message_id=***

参数: 

参数名 必选 类型 说明

key 是 string 登录用key

secret 是 string 登录用secret

message_id 是 int 消息id

返回示例

{

    "code": 0,

    "msg": "请求成功!",

    "data": null

}


2.6、getProjects 获取项目信息列表

**请求URL:

/api/qnapi/getProjects?key=***&secret=***&page=***&size=***

参数: 

参数名 必选 类型 说明

key 是 string 登录用key

secret 是 string 登录用secret

page 否 int 当前页(默认1页)

size 否 int 每页显示数量(默认20)

返回示例

{

    "code": 0,

    "msg": "请求成功!",

    "data": {

        "total": 184,                   // 总条数

        "per_page": 1,                

        "current_page": 1,          // 当前页

        "last_page": 184,           // 最后页

        "data": [

            {

                "project_id": "zomato",         // 项目编号(id)(即:服务项目标识ID) 获取手机号码使用

                "title": "zomato",                  // 项目名称

                "score": 39,                        // 价格积分

                "icon_path": "",                  //  项目图标路径

 "nums": 320                        //数量

            }

        ]

    }

}


2.7、getCountry 获取国家列表信息

**请求URL:

/api/qnapi/getCountry?key=***&secret=***&page=***&size=***

参数: 

参数名 必选 类型 说明

key 是 string 登录用key

secret 是 string 登录用secret

page 否 int 当前页(默认1页)

size 否 int 每页显示数量(默认20)

返回示例

{

    "code": 0,

    "msg": "请求成功!",

    "data": {

        "total": 184,                   // 总条数

        "per_page": 1,                

        "current_page": 1,          // 当前页

        "last_page": 184,           // 最后页

        "data": [

            {

                "name_en": "Zimbabwe",      // 英文名

                "name_zh": "Zimbabwe",      // 中文名

                "ucode": "zimbabwe",          // 编码(获取手机号时使用)

            }

        ]

    }

}


2.8 getCountryPriceNumsByProject 根据项目标识获取多个国家号码数量及价格

**请求URL:

/api/qnapi/getCountryPriceNumsByProject?project_id=***

参数: 

参数名 必选 类型 说明

project_id 是 string 项目id标识,如电报“tg”

page 否 int 当前页(默认1页)

size 否 int 每页显示数量(默认20)


返回示例

{

    "code": 0,

    "msg": "请求成功!",

    "data": {

        "total": 181,

        "per_page": 1,

        "current_page": 1,

        "last_page": 10,

        "data": [

            {

                "country_id": "32",                                          //国家标识ID

                "name_en": "罗马尼亚",                                       // 国家英文名

                "name_zh": "罗马尼亚",                                       // 国家中文名

                "icon_path": "http://150sms.com/ico/country/32.png",         //国家图标

                "nums": "362",                                               //号码数量

                "score": 68                                                  //价格积分

            }

        ]

    }

}


2.9 getOperations 根据国家PID获取运营商列表

**请求URL:

/api/qnapi/getOperations?key=***&secret=***&country=***

参数: 

参数名 必选 类型 说明

key 是 string 登录用key

secret 是 string 登录用secret

country 是 int 国家PID

返回示例

{

    "status":"success",

    "countryOperators":{

        "0":[

            "beeline",

            "megafon",

            "mts",

            "sber",

            "tele2",

            "rostelecom",

            "aiva"

        ]

    }

}


3、租号:


3.1:获取可租号的国家,项目及运营商列表(getRentServicesAndCountries)

**请求RUL:

/api/qnapi/getRentServicesAndCountries?key=***&secret=***&country=1&rent_time=12&operator=any

参数: 

参数名      必选        类型         说明

key         是          string       登录用key(在"账户信息"查看)

secret      是          string       登录用secret(在"账户信息"查看)

country     否          int          要列出的对应国家的项目及运营商

rent_time   否          int          租用号码的时间长(单位小时),最低4个小时,24小时以内只接收4或12,其他请以天数的倍数传参,如:24、48、72、96、...,最高1344小时,注:若参数不合规,则默认为4个小时

operator    否          string       运营商,请根据得到的列表值选择传递


返回示例:

{

    "code": 0,

    "msg": "",

    "data": {

        "countries": [

            {

                "pid": "0",                            国家pid参数,用于再次传递筛选项目

                "name_en": "Russian Federation",       国家英文名

                "name_zh": "俄罗斯"                    国家中文名

            },

            {

                "pid": "1",

                "name_en": "Ukraine",

                "name_zh": "乌克兰"

            }

        ],

        "operators": [                                 运营商列表

            "any",

            "3mob",

            "intertelecom",

            "kyivstar",

            "life",

            "lycamobile",

            "mts",

            "utel",

            "vodafone"

        ],

        "services": {

            "full": {                                                       项目pid

                "cost": 260,                                                号码对应的项目租用价格

                "search_name": "Полная арендаFull rent",                    项目名称

                "quant": {

                    "current": 0,                                           当前剩余数量

                    "total": 0                                              总数量

                }

            },

            "vk": {

                "cost": 24,

                "search_name": "Vkontakte",

                "quant": {

                    "current": 0,

                    "total": 0

                }

            }

        },

        "realHours": 12                                                     租用时长

    }

}



3.2:请求租用号码(getRentNumber)

**请求RUL:

/api/qnapi/getRentNumber?key=***&secret=***&service=tg&rent_time=12&operator=any&country=1

参数: 

参数名      必选        类型         说明

key         是          string       登录用key(在"账户信息"查看)

secret      是          string       登录用secret(在"账户信息"查看)

service     是          string       要租用的项目的pid

rent_time   是          int          租用时长(4或12或天数的倍数传参,如:24、48、72、96、...,最高1344小时)

operator    否          string       运营商

country     是          int          国家pid

返回示例:

无号码时返回如下:

{

    "code": 1,

    "msg": "NO_NUMBERS",

    "data": []

}

有号码时返回如下:

{

    "code": 0,

    "msg": "",

    "data": {

        "id": 7182636,                       ID

        "endDate": "2022-10-11 03:23:07",    到期时间

        "number": "79582359621"              号码

    }

}



3.3:获取我的租用号码列表(getRentList)

**请求RUL:

/api/qnapi/getRentList?key=***&secret=***

参数: 

参数名      必选        类型         说明

key         是          string       登录用key(在"账户信息"查看)

secret      是          string       登录用secret(在"账户信息"查看)

返回示例:

{

    "code": 0,

    "msg": "",

    "data": {

        "total": 1,

        "per_page": 10,

        "current_page": 1,

        "last_page": 1,

        "data": [

            {

                "id": "7182636",                         ID

                "project_pid": "ae",                     项目pid

                "project_til": "myGLO",                  项目名称

                "country_name_zh": "俄罗斯",             国家

                "operation_name": "any",                 运营商

                "mobile": "79587359620",                 手机号

                "content": "",                           短信内容

                "price": 10,                             价格

                "create_time": "2022-10-10 15:23:07",    创建时间

                "exp_time": "2022-10-11 03:23:07",       到期时间

                "status": 1,                             状态:1租用中,2释放,3到期

                "code": "",                              短信验证码

                "text": "",                              原始短信内容

                "surplus": "11小时",                     剩余时间(小时,分钟,秒)

                "status_txt": "有效"                     状态文本

            }

        ]

    }

}


3.4:变更状态请求(setRentStatus),如释放号码,或提前结束租用

说明:20分钟内释放号码,若不来验证码,则不扣费用;来了验证码或租用时间超出20分钟,则扣费

**请求RUL:

/api/qnapi/setRentStatus?key=***&secret=***

参数: 

参数名      必选        类型         说明

key         是          string       登录用key(在"账户信息"查看)

secret      是          string       登录用secret(在"账户信息"查看)

rent_id     是          int          租用号码列表的ID

status      是          int          1或2,1为提前结束到期,2为释放/取消租用

返回示例:

{

    "code": 0,

    "msg": "操作成功",

    "data": []

}


3.5:历史租用号码列表(getHistoryRentList)

**请求RUL:

/api/qnapi/getHistoryRentList?key=***&secret=***

返回示例:

{

    "code": 0,

    "msg": "",

    "data": {

        "total": 1,

        "per_page": 10,

        "current_page": 1,

        "last_page": 1,

        "data": [

            {

                "id": "7182636",                         ID

                "project_pid": "ae",                     项目pid

                "project_til": "myGLO",                  项目名称

                "country_name_zh": "俄罗斯",             国家

                "operation_name": "any",                 运营商

                "mobile": "79587359620",                 手机号

                "content": "",                           短信内容

                "price": 10,                             价格

                "create_time": "2022-10-10 15:23:07",    创建时间

                "exp_time": "2022-10-11 03:23:07",       到期时间

                "status": 1,                             状态:1租用中,2释放,3到期

                "code": "",                              短信验证码

                "text": "",                              原始短信内容

                "surplus": "11小时",                     剩余时间(小时,分钟,秒)

                "status_txt": "有效"                     状态文本

            }

        ]

    }

}