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

POST /api/resellers/addMessages

Empfangene SMS im Batch an den Onlinesim-Server weiterleiten

Diese Anfrage leitet mehrere eingehende SMS in einer einzigen Anfrage an den Onlinesim-Server weiter.

Wir empfehlen, diese Methode anstelle von addMessage zu verwenden und SMS gebündelt zu senden, z. B. einmal alle 5 Sekunden.

Parameter

header2

Name	Typ	Beschreibung
`Authorization`*	`string`	Siehe Details hier
`Content-Type`*	`string`	Header `Content-Type` und Kodierung Enumeration:`application/json; charset=utf-8`

Anforderungs-Body

Ihr Server sollte diese Anfrage senden, wenn neue Nachrichten empfangen wurden und mehrere SMS gleichzeitig übertragen werden müssen.

Content-Typeapplication/json

Schema

Bodyobject

messagesobject[]Erforderlich

Array von Nachrichten.

itemsobject

numberoneOfErforderlich

Telefonnummer im internationalen Format oder Nummern-ID

(siehe Serverantwort auf die Anfrage sendNumbersOnline)

Eins von

[0]integer

[1]string

fromstringErforderlich

Name oder Nummer des Absenders

messagestringErforderlich

Nachrichtentext

datestring

Datum und Uhrzeit des Nachrichtenempfangs (in jedem Format, z. B. 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

Beispiele

Example payload of your server `addMessages` request

{
  "messages": [
    {
      "number": "33712345678",
      "from": "Telegram",
      "message": "Code: 12345"
    },
    {
      "number": "33712345679",
      "from": "WhatsApp",
      "message": "Code: 56789"
    }
  ]
}

Antworten

200

Antwort des Onlinesim-Servers

Content-Typeapplication/json

Schema

Responseobject

responsestringErforderlich

1, wenn mindestens eine Nachricht erfolgreich verarbeitet wurde, sonst 0

Enumeration:01

totalintegerErforderlich

Gesamtzahl der verarbeiteten Einträge

successintegerErforderlich

Anzahl erfolgreich verarbeiteter Nachrichten

failedintegerErforderlich

Anzahl der Nachrichten mit Fehler

resultsobject[]Erforderlich

Verarbeitungsergebnisse für jede Nachricht

itemsobject

indexintegerErforderlich

Index der Nachricht im Eingabearray

numberstringErforderlich

Telefonnummer

fromstringErforderlich

Name oder Nummer des Absenders

responsestringErforderlich

Verarbeitungsstatus der einzelnen Nachricht

Enumeration:01

errorstring

"Fehlercode:

NO_OPERATION - keine aktive Operation für die Nummer"

Beispiele

Onlinesim server response example for `addMessages` request21 Zeilen

{
  "response": "1",
  "total": 2,
  "success": 1,
  "failed": 1,
  "results": [
    {
      "index": 0,
      "number": "33712345678",
      "from": "Telegram",
      "response": "1"
    },
    {
      "index": 1,
      "number": "33712345679",
      "from": "WhatsApp",
      "response": "0",
      "error": "NO_OPERATION"
    }
  ]
}

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