Eine Nummer hinzufügen
POSThttps://{ourserver.com}/api/resellers/addNumber
Fügt Ihrer Liste eine Nummer hinzu, im Gegensatz zu sendNumbersOnline, das die ganze Liste sendet. Verwenden Sie es, um neue Nummern hinzuzufügen, ohne die Liste erneut zu senden.
Ist die Nummer bereits auf Ihrer Liste, wird sie ersetzt: Der alte Eintrag wird entfernt, und die Nummer erhält eine neue ID. Die Nummer wird vom Server innerhalb von etwa einer Minute aktiviert. Die Ländervorwahl wird nicht vorangestellt: Übergeben Sie die Nummer mit ihr.
Die Anfrage bestätigt außerdem, dass Ihr Server läuft.
Parameter
header1
| Name | Typ | Beschreibung |
|---|---|---|
Authorization* | string | Siehe Details hier |
Anforderungs-Body
Content-Type
application/jsonSchema
schemaobject
Alles von
[0]objectEine von Ihnen bereitgestellte Nummer.
[1]object
Beispiele
number
Eine Nummer mit Portnamen, nicht zur Miete
{
"number": "+46050910804",
"country_id": 46,
"date_start": 1658209063,
"port_id": "Port1",
"rent": 0
}Antworten
200Die Nummer ist hinzugefügt
Content-Type
application/jsonSchema
schemaobject
responsestringErforderlich
Enumeration:1Beispiel:1idintegerErforderlich
ID der Nummer auf unserem ServerBeispiel:1042Beispiele
success
Die Nummer ist hinzugefügt
{
"response": "1",
"id": 1042
}400number fehlt oder ist keine Telefonnummer, das Land ist unbekannt, equipment_id ist ungültig, port_id wird bereits von einer anderen Ihrer Nummern verwendet, oder die Nummer ist unter einem anderen Konto online
Content-Type
application/jsonSchema
schemaobjectFehlerantwort: response und message enthalten denselben Fehlercode.
responsestringErforderlich
Enumeration:ERROR_PARAMSmessagestringErforderlich
Beispiel:ERROR_PARAMS401Kein API-Schlüssel, oder der Schlüssel existiert nicht. Der Body ist der reine Text Unauthorized.
Eine Anfrage mit Accept: application/json erhält stattdessen HTTP 200 mit {"response":"ERROR_WRONG_KEY"}.
Content-Type
text/htmlSchema
schemastring
Enumeration:Unauthorized.Beispiel:Unauthorized.403Verboten: Der API-Schlüssel ist gültig, aber die Anfrage wird abgelehnt. Fehlercodes:
ERROR_DISABLED — das Partnerkonto ist nicht aktiviert;
ERROR_BANNED — das Partnerkonto ist gesperrt;
ERROR_IP — die Anfrage kommt von einer IP-Adresse, die nicht auf der Positivliste des Kontos steht;
ERROR_RENT — rent wird angefordert, aber das Konto hat keinen Mietzugang (nur addNumber).
ERROR_DISABLED — das Partnerkonto ist nicht aktiviert;ERROR_BANNED — das Partnerkonto ist gesperrt;ERROR_IP — die Anfrage kommt von einer IP-Adresse, die nicht auf der Positivliste des Kontos steht;ERROR_RENT — rent wird angefordert, aber das Konto hat keinen Mietzugang (nur addNumber).Content-Type
application/jsonSchema
schemaobject
responsestringErforderlich
FehlercodeEnumeration:ERROR_DISABLEDERROR_BANNEDERROR_IPERROR_RENTmessagestringErforderlich
Derselbe FehlercodeBeispiele
ERROR_IP
Anfrage von einer IP-Adresse außerhalb der Positivliste
{
"response": "ERROR_IP",
"message": "ERROR_IP"
}Codebeispiele
Beispiele werden generiert...