posthttps://{ourserver.com}/api/resellers/addNumbers

POST /api/resellers/addNumbers

Mehrere Telefonnummern zur aktuellen Liste hinzufügen

Diese Anfrage ermöglicht es Ihnen, Nummern massenhaft zur Liste der vorhandenen auf dem Onlinesim-Server hinzuzufügen.

Parameter

header1
NameTypBeschreibung
Authorization*string

Siehe Details hier

Anforderungs-Body

Content-Typeapplication/json
Schema
Bodyobject
numbersobject[]
itemsobject
numberstring

Telefonnummer im internationalen Format (mit +-Zeichen)

country_idinteger

Ländercode (gemäß Länderliste)

≥ 1
port_idstring

Eindeutiger Portname, der in unserer Benutzeroberfläche auf der Seite zur Verwaltung Ihrer Nummern angezeigt wird.

Der Standardwert entspricht der Telefonnummer (dem Wert des Parameters number)

maxLen: 100
usedstring[]

Liste der Dienste, die für diese Nummer als „verwendet" markiert werden sollen. Verwenden Sie Werte aus der Spalte Service der Dienste-Tabelle (z.B. vkcom, tg, google).

Der Server speichert diesen Wert etwa eine Woche lang im Cache und stellt ihn beim Aktivieren der Nummer wieder her. Wenn Sie ihn länger benötigen, senden Sie die Anfrage erneut.

Wenn used nicht in der Anfrage enthalten ist, wird der zwischengespeicherte Wert beibehalten. Um ihn zu löschen, übergeben Sie ein leeres Array [].

itemsstring
rentinteger

Mietmodus für diese Nummer:

1 - aktiviert,

0 - deaktiviert,

Enumeration:01
operatorinteger

MCC + MNC-Codes des Betreibers (diese Codes sind in den ersten 5 Ziffern der IMSI enthalten)

date_startinteger

Datum und Uhrzeit der Nummernveröffentlichung (UNIX-Zeitstempel)

teststring

Optionales Feld für den Anfragetext der Reseller API v2. Kann einen von zwei Werten annehmen: test1 oder test2.

Bei Wert test1 wird die Anfrage an den Server gesendet, aber die mit dieser Anfrage übermittelten Daten werden von unserem Server nicht gespeichert (die Funktion wird nicht durch diese Anfrage ausgeführt).

Wenn der Parameter test2 ist, gibt der Onlinesim-Server in der Antwort den Textkörper Ihrer Anfrage zurück.

Kann als Query-Parameter (für GET) oder als Feld im Anfragetext (für POST) übergeben werden. Beide Methoden sind gleichwertig, aber die gleichzeitige Verwendung wird nicht empfohlen.

Enumeration:test1test2

Antworten

200

Antwort des Onlinesim-Servers

Content-Typeapplication/json
Schema
Responseobject
responseoneOf

1, wenn die Anfrage erfolgreich ausgeführt wurde, oder gibt eine Fehlermeldung aus

Eins von
[0]string
[1]integer
idsobject

Ein Objekt, bei dem die Schlüssel Telefonnummern (im internationalen Format, z. B. "+234112233445") und die Werte die entsprechenden, vom Server vergebenen IDs sind

[additionalProperties]oneOf
Eins von
[0]integer
[1]nullNullable
[2]string

Die der Nummer zugewiesene ID (oder null für gelöschte Nummern, oder fail — dies geschieht, wenn eine Nummer in einem falschen Format übergeben wird)

Enumeration:fail

Beispiele

Onlinesim server response example (successfuly added few numbers, others were passed with incorrect country code)
{
  "response": 1,
  "ids": {
    "234112233445": 1042,
    "234112233446": 1043,
    "234112233447": "fail"
  }
}
Incorrect key passed
[
  {
    "response": "ERROR_WRONG_KEY"
  }
]
401

Nicht autorisiert. Der Anfrage fehlt der API-Schlüssel oder es wurde ein ungültiger API-Schlüssel verwendet. Einige Endpunkte können anstelle von 401 einen 200-Status mit der Meldung ERROR_WRONG_KEY zurückgeben — prüfen Sie den Antworttext

Content-Typetext/plain
Schema
Responsestring
Enumeration:Unauthorized
403

Verboten. Die Anfrage wurde verstanden, aber aufgrund fehlender Berechtigungen abgelehnt

Content-Typeapplication/json
Schema
Responseobject
errorobjectErforderlich
statusinteger

HTTP-Antwortcode im Textformat

codestring
messagestring

Mögliche Fehlercodes: - ERROR_DISABLED - Partnerkonto ist nicht aktiviert - ERROR_IP - IP-Adresse befindet sich nicht in der Liste der erlaubten Adressen - Allowlist (siehe ) - ERROR_RENT - Konto hat keinen Zugriff auf die Miete

Enumeration:ERROR_DISABLEDERROR_IPERROR_RENT
messagestringErforderlich
Enumeration:ERROR_DISABLEDERROR_IPERROR_RENT
detailsobject[]Erforderlich
itemsobject

Codebeispiele

Beispiele werden generiert...