API für Partner
v1.0Allgemeine Beschreibung
Die API ist für aktuelle und potenzielle Onlinesim-Partner gedacht. Sie ermöglicht es Ihnen, Ihre Nummern zu monetarisieren, indem Sie sie unseren Kunden für den Empfang von SMS von verschiedenen Diensten und Anwendungen zur Verfügung stellen.
Derzeit sind zwei Versionen der API implementiert:
- v1 eignet sich für Partner, die bereits über eine eigene Logik für die Arbeit mit Nummern verfügen. In diesem Schema fragt unser Server bei Ihrem Server Informationen über verfügbare Nummern ab und fordert, wenn eine geeignete Nummer gefunden wird, diese für den SMS-Empfang an.
- v2 hat ein umgekehrtes Schema: Die Hauptlogik der Vorgänge liegt auf unserer Seite. Sie senden uns regelmäßig eine Liste Ihrer Nummern und leiten eingehende SMS an uns weiter, während die Nummern sofort für Kundenbestellungen verfügbar sind.
v1 API
Unser Server sendet jede Anfrage als HTTP POST mit einem JSON-Body (UTF-8) an die von Ihnen angegebene URL; der Methodenname steht im Feld action und Ihr Partnerschlüssel im Feld key. Ihre Antwort wird aus ihrem JSON-Body gelesen; ihr HTTP-Status wird nicht verwendet.
Anforderungen für v1:
- Antworten sind JSON in UTF-8
- Die in der Antwort von GET_SERVICES verwendeten Länder- und Dienstnamen müssen mit den entsprechenden Listen der Länder und Dienste übereinstimmen
- Eine Nummer sollte jeweils nur für einen Vorgang verwendet werden: Ihr Server kann dieselbe Nummer für einen anderen Dienst erst ausgeben, nachdem der vorherige Vorgang abgeschlossen ist
- Webhook PUSH_SMS: Ihr Server muss SMS, die von Nummern mit aktiven Vorgängen empfangen werden, automatisch an den Onlinesim-Server weiterleiten
- Die Filterung kann entweder auf unserer Seite oder auf Ihrer Seite durchgeführt werden. Teilen Sie uns vor der Integration mit, welche Option Sie bevorzugen
- Beantworten Sie GET_NUMBER schnell: Die Anfrage hat ein Timeout (standardmäßig 10 Sekunden, abhängig von der Integration), nach dem die Bestellung an einen anderen Partner geht
Checkliste für die Integration:
-
Es müssen 3 Methoden und ein Webhook implementiert werden:
GET_SERVICES - fragt die Anzahl der Nummern nach Land und Dienst bei Ihrem Server ab
GET_NUMBER - reserviert eine Nummer für einen kurzen Zeitraum (standardmäßig 15 Minuten) mit angegebenen Parametern zum Empfang von SMS von einem bestimmten Dienst für einen angegebenen Betrag
PUSH_SMS (Webhook) - wenn eine reservierte Nummer eine SMS empfängt, sendet Ihr Server sie an unseren Server
FINISH_ACTIVATION - schließt den Vorgang mit bestimmten Parametern (abhängig vom Ergebnis)
- Kontaktieren Sie uns per E-Mail oder Telegram, um ein Partnerprofil zu erstellen, die URL für Anfragen von unserer Seite anzugeben, einen Link für den Webhook zu erhalten und die Nummern zu testen.
- Nach erfolgreichen Tests sind Ihre Nummern innerhalb weniger Stunden für unsere Kunden verfügbar.
v2 API
Die Reseller API v2 ermöglicht es Ihnen, Ihre Hardware und Nummern zu integrieren, damit Kunden sie anschließend über unsere Website für den SMS-Empfang nutzen können. Wir haben versucht, die Integration so einfach wie möglich zu gestalten. Um loszulegen, müssen Sie:
- 2 Methoden implementieren:
-
sendNumbersOnline - sendet die Liste Ihrer Nummern an unseren Server; diese Anfrage sollte alle 5 Minuten gesendet werden, um die Nummernliste zu aktualisieren und als Bestätigung der Betriebszeit Ihres Servers;
-
Weiterleitung eingehender SMS an unseren Server — addMessage (eine Nachricht pro Anfrage) oder addMessages (stapelweise).
- Den Support kontaktieren, um
_SERVER_URL_zu erhalten - Die übrigen Anfragen sind optional, ihre Implementierung ist nicht erforderlich, ihre Beschreibung ist jedoch in der Dokumentation verfügbar.
- Die
/api/resellers-Anfragen akzeptieren einen optionalen Parametertestzum Ausprobieren der Integration, in der Abfragezeichenfolge oder im Body: Mittest1wird die Anfrage ausgeführt und wie üblich beantwortet, ihre Datenbankänderungen werden jedoch zurückgesetzt; mittest2wird sie nicht ausgeführt, und die Antwort ist ein Dump der Anfrage, wie unser Server sie empfangen hat. Eine Anfrage mittestbestätigt nicht die Betriebszeit Ihres Servers.
Nachdem Sie eine Antwort erhalten haben, dass die Anfrage sendNumbersOnline erfolgreich ausgeführt wurde, wenden Sie sich an den Partner-Support, um zu prüfen, ob unser Server Nachrichten über die Anfragen addMessage oder addMessages empfängt. Im Erfolgsfall sind Ihre Nummern innerhalb weniger Stunden für unsere Kunden verfügbar.
Anhang
Prozessschema
Nutzungsbedingungen:https://onlinesim.io/documentation/offer
Kontakt
- E-Mail:partners@onlinesim.ru
- URL:https://onlinesim.io
Lizenz
Server
{yourserver}
URL Ihres Servers
Variablen:
| Name | Standard | Enumeration | Beschreibung |
|---|---|---|---|
yourserver | https://{yourserver.com} | - |