对于开发者

这一部分是API文档,用于将您的服务与SMS-Man和自动购买号码连接起来。

API v2.0

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

API端口描述

所有的请求必须进入http://api.sms-man.com/cn/rent-api/ POST或GET请求。所有的请求中必须含有 token参数形式的API密钥

查询余额请求

http://api.sms-man.com/control/get-balance?token=$token

参数

场地 类型 需要 价值
token String yes 您的API密钥

结果

{"balance":"799.70"}

可能的错误

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}

调用限制

http://api.sms-man.com/control/limits?token=$token&country_id=$country_id&application_id=$application_id

参数

场地 类型 需要 价值
token String yes 您的API密钥
country_id Integer no
国家号码
application_id Integer no
号码服务

结果

[{"application_id":"1","country_id":"1","numbers":"32302"},{"application_id":"1","country_id":"2","numbers":"3494"}]

可能的错误

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

请求号码

http://api.sms-man.com/control/get-number?token=$token&country_id=$country_id&application_id=$application_id

参数

场地 类型 需要 价值
token String yes 您的API密钥
country_id Integer no
国家号码
application_id Integer no
号码服务
ref String no 转移返利ID

结果

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539"}

可能的错误

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

获取短信

http://api.sms-man.com/control/get-sms?token=$token&request_id=$request_id

参数

场地 类型 需要 价值
token String yes 您的API密钥
request_id Integer yes 要求ID

结果

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539", "sms_code" => "1243"}

可能的错误

{"request_id":1,"country_id":1,"application_id":1,"number":"79002415539", "error_code" => "wait_sms", "error_msg" => "Still waiting..."}

更改请求状态

http://api.sms-man.com/control/set-status?token=$token&request_id=$request_id&status=$status

参数

场地 类型 需要 价值
token String yes 您的API密钥
request_id Integer yes 要求ID
状态 String yes ready / close / reject / used

结果

{"request_id": 1, "success": true}

可能的错误

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}{"success":false,"error_code":"wrong_status","error_msg": "Status $status does not exists"}

请求可用号码的数量

http://api.sms-man.com/control/get-prices?token=$token&country=$country

参数

场地 类型 需要 价值
token String yes 您的API密钥
country_id Integer no
国家号码

结果

{"0":{"1":{"cost":"15","count":6455},"2":{"cost":"50","count":124}}, "1":{"3":{"cost":"6","count":1000}}

可能的错误

{"success":false,"error_code":"wrong_token","error_msg": {"token": "Wrong token!"}}

获取所有国家的列表

http://api.sms-man.com/control/countries?token=$token

参数

场地 类型 需要 价值
token String yes 您的API密钥

结果

[{'id':0,'title':"Russia"}, {'id':3,'title':"China"}]

可能的错误

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}

获取所有服务的列表

http://api.sms-man.com/control/applications?token=$token

参数

场地 类型 需要 价值
token String yes 您的API密钥

结果

[{'id':'1','name':"Vkontakte", "code" => "vk"}, {'id':'2','name':"WeChat", "code" => "wb"}, {'id':'3','name':"Telegram", "code" => "tg"}]

可能的错误

{"success":false,"error_code":"wrong_token","error_msg": "Wrong token!"}
{{country.title}}
{{country.id}}
logo {{service.title}}
{{service.id}}