Mehrere Nummern entfernen
DELETEhttps://{ourserver.com}/api/resellers/removeNumbers
Entfernt mehrere Ihrer über diese API hinzugefügten Nummern, nach Telefonnummer und/oder nach ID. Jede
Nummer, die zu einem Wert in ids oder numbers passt, wird entfernt.
Die Anfrage bestätigt außerdem, dass Ihr Server läuft.
Parameter
header1
| Name | Typ | Beschreibung |
|---|---|---|
Authorization* | string | Siehe Details hier |
query1
| Name | Typ | Beschreibung |
|---|---|---|
test | string | Testmodus. Er kann auch im Anfragetext übergeben werden.
Eine Anfrage mit einem beliebigen nicht leeren Enumeration: test1test2 |
Anforderungs-Body
Content-Type
application/jsonSchema
schemaobjectMindestens eines von ids und numbers darf nicht leer sein. Ein einzelner Wert statt eines Arrays wird akzeptiert.
idsinteger[]IDs der Nummern
numbersstring[]Telefonnummern mit Ländervorwahl (ein optionales führendes + wird ignoriert)
Beispiele
byNumbersAndIds
Zwei Nummern nach Telefonnummer und eine nach ID
{
"numbers": [
"+4695000051",
"+4695000052"
],
"ids": [
110251
]
}Antworten
2001, wenn mindestens eine Nummer entfernt wurde, 0, wenn nichts passte
Content-Type
application/jsonSchema
schemaobject
responsestringErforderlich
Enumeration:01Beispiel:1Beispiele
removed
Die Nummern sind entfernt
{
"response": "1"
}notFound
Keine der Nummern steht auf Ihrer Liste
{
"response": "0"
}400Sowohl ids als auch numbers fehlen oder sind leer
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...