Gateway

  2. Home
  4. Gateway
  6. HTTP API
  8. Logbuch

Logbuch

Über diesen Endpunkt können Sie die letzten Einträge Ihrer Logbücher abfragen. Sie erhalten bei jeder Abfrage maximal 100 Einträge zurück.

Bitte richten Sie Ihre Anfrage an folgende Adresse:
https://gateway.sms77.io/api/journal

Benötigte Parameter
Parameter Beschreibung Mögliche Werte
type Typ des Logbuchs, welches Sie abfragen möchten (Voice, SMS etc) outbound für verschickte SMS
inbound für eingehende SMS
voice für Voice Nachrichten
replies für Antworten auf Ihre SMS

Optionale Parameter

Um die Daten zusätzlich zu filtern, verwenden Sie bitte folgende Parameter:
Parameter Beschreibung Mögliche Werte
date_from Startdatum, ab dem gesucht werden soll im Format JJJJ-MM-TT 2020-01-01
date_to Enddatum, bis zu dem gesucht werden soll im Format JJJJ-MM-TT 2020-05-30
id ID der Nachricht 1234567
limit Limitiert die Anzahl der zurückzugebenden Einträge. Muss eine Ganzzahl zwischen 1-100 sein. 1
100 – standard
state Status der Nachricht. Dies könnte z.B. completed / failed bei Voice oder DELIVERED / NOTDELIVERED etc. bei SMS sein. completed
failed
DELIVERED
to Empfängerrufnummer im beliebigen Format 49176123456789

Rückgabe

Sie erhalten die Informationen als JSON formatiert zurück. Je nachdem, welches Logbuch Sie abfragen, erhalten Sie unterschiedliche Daten zurück.

Beispiele

Abfrage der zuletzt verschickten SMS:

Anfrage:
https://gateway.sms77.io/api/journal?p=api-schluessel&type=outbound

Antwort:

[
    {
        "id": "77130579436",
        "to": "49176123456789",
        "from": "4915126716517",
        "text": "Hallo Welt.",
        "timestamp": "2020-10-22 12:36:01.584",
        "price": "0.075",
        "dlr": "DELIVERED",
        "dlr_timestamp": "2020-10-22 12:36:26.301",
        "mccmnc": "26202",
        "latency": "24.7170",
        "type": "direct",
        "connection": "http",
        "label": null,
        "foreign_id": null
    },
    {
        "id": "77130579434",
        "to": "49176123456789",
        "from": "4915126716517",
        "text": "Dies ist eine Test-SMS",
        "timestamp": "2020-10-22 12:36:01.384",
        "price": "0.0750",
        "dlr": "DELIVERED",
        "dlr_timestamp": "2020-10-22 12:36:15.000",
        "mccmnc": "26202",
        "latency": "13.6160",
        "type": "direct",
        "connection": "smpp",
        "label": "customer_1",
        "foreign_id": "028be8f1-46c7-4a9b-8100-22ed18c6cad4"
    }
]

Abfrage der zuletzt versandten Sprachnachrichten:

Anfrage:
https://gateway.sms77.io/api/journal?p=api-schluessel&type=voice

Antwort:

[
  {
    "id": "274744",
    "from": "491771783130",
    "to": "491716992343",
    "xml": false,
    "text": "Dieser Text wurde umgewandelt und vorgesprochen.",
    "duration": "3",
    "status": "completed",
    "error": "",
    "timestamp": "2021-08-02 14:20:26",
    "price": "0.075"
  }
]

Abfrage der letzten eingegangenen SMS:

Anfrage:
https://gateway.sms77.io/api/journal?p=api-schluessel&type=inbound

Antwort:

[
  {
    "id": "856849",
    "price": "0.0000",
    "sender": "SuperSys",
    "system": "491771783130",
    "text": "Hello \nYour OTP verification code is 3984.",
    "time": "2021-07-02 08:35:19"
  }
]