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

POST /api/resellers/addNumber

Bestimmte Telefonnummern an den Onlinesim-Server senden

Diese Anfrage ermöglicht es Ihnen, Nummern einzeln auf den Onlinesim-Server hinzuzufügen, im Gegensatz zu sendNumbersOnline, das alle aktiven Nummern als vollständige Liste sendet.

Dies kann besonders nützlich sein, wenn Sie neue Nummern zur bereits vorhandenen Liste hinzufügen müssen, anstatt die geänderte Liste jedes Mal zu übermitteln, wenn Sie Nummern hinzufügen.

Parameter

header1

Name	Typ	Beschreibung
`Authorization`*	`string`	Siehe Details hier

Anforderungs-Body

Hinzufügen Ihrer neuen Nummern zur Liste der vorhandenen auf dem Onlinesim-Server.

Content-Typeapplication/json

Schema

Bodyobject

Schema des Anfragetexts

Alles von

[0]object

numberstringErforderlich

Telefonnummer im internationalen Format

country_idintegerErforderlich

Ländercode (laut Länderliste)

operatorinteger

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

date_startinteger

Datum und Uhrzeit der Platzierung der Telefonnummer im UNIX-Timestamp-Format

Format:date-time

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[]

itemsstring

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 ab dem letzten Mal, an dem er übermittelt wurde, und verwendet ihn, wenn die Nummer aktiviert wird. Jede wiederholte Übermittlung des Parameters aktualisiert den Cache und startet einen neuen Countdown.

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

rentintegerErforderlich

Mietmodus für diese Nummer:

1 - aktiviert,

0 - deaktiviert,

Enumeration:01

[1]object

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

Beispiele

Payload example for `addNumber` from your server

{
  "number": "+46050910804",
  "country_id": 46,
  "operator": 24012,
  "date_start": 1658209063,
  "port_id": "Port1",
  "rent": 0,
  "test": "test1"
}

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

idinteger

Telefonnummern und ihre IDs: id - gibt die ID für jede Nummer zurück (oder weist eine ID für eine neue Nummer zu) oder weist null für gelöschte Nummern zu

Beispiele

Onlinesim server response example (successfuly added new numbers)

{
  "response": 1,
  "ids": {
    "+234112233445": 1042,
    "+234112233446": 1043,
    "+234112233447": 1044
  }
}

Incorrect key passed

[
  {
    "response": "ERROR_WRONG_KEY"
  }
]

400

Erforderliche Parameter fehlen oder sind inkorrekt (der Anfragetext muss die Parameter mit den korrekten Bezeichnungen enthalten, wie in der Dokumentation angegeben)

Content-Typeapplication/json

Schema

Responseobject

responsestringErforderlich

Enumeration:ERROR_PARAMS

messagestringErforderlich

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...