Für Entwickler

Hier findest du die API-Dokumentation für die Anbindung deines Services an SMS-Man und den automatischen Kauf von Telefonnummern.

Kompatible API API 2.0 API mieten

API v2.0

API ist ein Protokoll für die Interaktion zwischen deiner Software und unserem Aktivierungs Server. Die API wird benötigt, um den Prozess des SMS-Empfangs auf deiner Seite zu automatisieren. Um mit der API arbeiten zu können, musst du deinen API-Schlüssel verwenden, den du auf der Profil Seite. Unsere Software ist vollständig kompatibel mit den Websites der Wettbewerber.

API-Protokoll Beschreibung

Alle Anfragen sollten an https://api.sms-man.com/control/ gehen. POST or GET request. Alle Anfragen müssen mit einem API-Schlüssel in Form des Token Parameter enthalten

Kontostand anfordern

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

Parameter

Feld	Typ	Erforderlich	Wert
token	String	yes	Dein API-Schlüssel

Ergebnis

{"balance":"799.70"}

Mögliche Fehler

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

Limits erhalten

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

Parameter

Feld	Typ	Erforderlich	Wert
token	String	yes	Dein API-Schlüssel
country_id	Integer	no	Nummer Land
application_id	Integer	no	Telefonnummern Service

Ergebnis

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

Mögliche Fehler

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

Eine Telefonnummer anfordern

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

Parameter

Feld	Typ	Erforderlich	Wert
token	String	yes	Dein API-Schlüssel
country_id	Integer	no	Nummer Land
application_id	Integer	no	Telefonnummern Service
ref	String	no	Übergabe Überweisungs-ID

Ergebnis

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

Mögliche Fehler

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

Sms erhalten

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

Parameter

Feld	Typ	Erforderlich	Wert
token	String	yes	Dein API-Schlüssel
request_id	Integer	yes	ID anfordern

Ergebnis

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

Mögliche Fehler

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

Status der Änderungsanfrage

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

Parameter

Feld	Typ	Erforderlich	Wert
token	String	yes	Dein API-Schlüssel
request_id	Integer	yes	ID anfordern
Status	String	yes	ready / close / reject / used

Ergebnis

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

Mögliche Fehler

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

Anfrage nach der Anzahl der verfügbaren Telefonnummern

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

Parameter

Feld	Typ	Erforderlich	Wert
token	String	yes	Dein API-Schlüssel
country_id	Integer	no	Nummer Land

Ergebnis

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

Mögliche Fehler

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

Liste aller Länder anzeigen

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

Parameter

Feld	Typ	Erforderlich	Wert
token	String	yes	Dein API-Schlüssel

Ergebnis

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

Mögliche Fehler

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

Liste aller Services abrufen

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

Parameter

Feld	Typ	Erforderlich	Wert
token	String	yes	Dein API-Schlüssel

Ergebnis

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

Mögliche Fehler

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