API接口文档

2023-12-27 00:01:40 • By Luban Sms

验证码接收Api

API端口描述

API是你的软件和我们的激活服务器之间的互动协议。 服务器之间的互动协议。为了使您的短信接收过程自动化,需要API。 要使用API,你必须使用你的API密钥,我们的软件与竞争对手的网站完全兼容

所有的请求必须进入http(s)://lubansms.com/v2/api/ GET请求。所有的请求中必须含有 token参数形式的API密钥。

你的API密钥请登陆平台查看.



查询余额请求

接口 : http(s)://lubansms.com/v2/api/getBalance?apikey=YOUR_APIKEY

结果

{"code":0,"msg":"","balance":"96.72"}

可能的错误

{"code":400,"msg":"不正确的apikey"}


请求号码

接口 : http(s)://lubansms.com/v2/api/getNumber?apikey=YOUR_APIKEY&service_id=service_id

参数

service_id(必填) :服务编号,通过获取服务接口获取

结果

{"code":0,"msg":"","number":"79781901206","request_id":230698}

可能的错误

{"code":400,"msg":"不正确的apikey"}


更改请求状态

接口 : http(s)://lubansms.com/v2/api/setStatus?apikey=YOUR_APIKEY&request_id=13&status=status

参数

status(必填) :值:reject 释放号码 类型:string

结果

{"code":0,"msg":"success"}

可能的错误

{"code":400,"msg":"不正确的apikey"}


获取短信

接口 : http(s)://lubansms.com/v2/api/getSms?apikey=YOUR_APIKEY&request_id=request_id

参数

request_id(必填) :通过请求号码API得到的request_id

结果【等待短信】

{"code":0,"msg":"wait","sms_msg":{"request_id":"244936588","application_id":133,"country_id":1,"number":"79587588703"}}

结果【收到短信】

{"code":0,"msg":"success","sms_code":"380682"}

结果【号码已关闭(超时未收到)】

{"code":400,"msg":"wrong_status"}

可能的错误

{"code":400,"msg":"不正确的apikey"}


获取国家列表

接口 : http(s)://lubansms.com/v2/api/countries?apikey=YOUR_APIKEY

结果

{"code":0,"msg":[{"id":"1","name_en":"Russian Federation","name_cn":"俄罗斯","code":"RU"}]}

返回参数:id 为 获取号码接口的 country_id

可能的错误

{"code":400,"msg":"不正确的apikey"}


获取服务列表

接口 : http(s)://lubansms.com/v2/api/List?apikey=YOUR_APIKEY&country=countryName&service=serviceName&language=en&page=1

参数

country(选填) :国家名称,例如 中文:美国 language参数对应zh 英文:USA language参数对应en

service(选填) :服务名称,支持模糊搜索 例如: whatsapp 、微信

language(选填) :语言 支持 zh、en ,country参数如果有填写,必须提交对应参数的语言

page(选填) :页码,不填默认第一页

结果

{"code":0,"msg":[{"service_id":"121949","country_name_zh":"u8d8au5357","country_name_en":"Vietnam","service_name":"Tinder","provider":"maxsim","cost":0.27},{"service_id":"328373","country_name_zh":"u8d8au5357","country_name_en":"Vietnam","service_name":"Tinder","provider":"linesms","cost":0.24}]}

返回参数:service_id 是服务编号,用于请求号码接口

可能的错误

{"code":400,"msg":"不正确的apikey"}


Luban Sms 短信收发