Statistiken

Rufen Sie detaillierte Statistiken Ihres Accounts direkt über unsere API ab.

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

Optionale Parameter

Zusätzlich zu den Daten zur Authentifizierung können folgende Parameter angegeben werden:

Parameter	Beschreibung	Mögliche Werte
start	Startdatum der Statistiken im Format JJJJ-MM-TT. Standardmäßig wird das Datum von vor 30 Tagen gesetzt.	2020-01-01
end	Enddatum der Statistiken. Standardmäßig der aktuelle Tag.	2020-05-30
label	Zeigt nur Daten eines bestimmten Labels an.	all – Zeigt alle Daten, Standard. kunden_label1 kunden_label2
subaccounts	Erhalten Sie die Daten nur zum Hauptaccount, zu allen Ihren (Sub-)Accounts oder nur zu spezifischen Subaccounts	only_main – Nur Daten des Hauptaccounts, Standard. all – Daten aller Accounts 9123456 – Subaccount-ID
group_by	Legt die Gruppierung der Daten fest	date – Standard label subaccount country

Rückgabe

Sie erhalten die Informationen als JSON formatiert zurück in Form von einer Liste mit Objekten.

Beispiel 1

Abfrage der Statistiken der letzten 30 Tage.

Anfrage:
https://gateway.sms77.io/api/analytics?p=api-schlüssel

Antwort:

[
    {
        "date": "2020-05-13",
        "hlr": 0,
        "inbound": 72,
        "mnp": 0,
        "sms": 145,
        "usage_eur": 0.208,
        "voice": 0
    },
    {
        "date": "2020-05-14",
        "hlr": 0,
        "inbound": 72,
        "mnp": 0,
        "sms": 1,
        "usage_eur": 0.508,
        "voice": 0
    },
    {
        "date": "2020-05-15",
        "hlr": 0,
        "inbound": 72,
        "mnp": 0,
        "sms": 38,
        "usage_eur": 2.908,
        "voice": 0
    },
    {
        "date": "2020-05-16",
        "hlr": 0,
        "inbound": 72,
        "mnp": 0,
        "sms": 2,
        "usage_eur": 0.208,
        "voice": 0
    }
]

Beispiel 2

Abfrage der Statistiken von 2019, gruppiert nach Zielland. Sie erhalten als country den ISO 3166-1 alpha-2 Code des jeweiligen Landes. Sofern dieser leer ist, handelt es sich um ein nicht feststellbares Land.

Anfrage:
https://gateway.sms77.io/api/analytics?p=api-schlüssel&start=2019-01-01&end=2019-12-31&group_by=country

Antwort:

[
    {
        "country": "DE",
        "inbound": 43744,
        "hlr": 333,
        "mnp": 167,
        "sms": 149046,
        "usage_eur": 11204.0564,
        "voice": 19
    },
    {
        "country": "",
        "inbound": 43744,
        "hlr": 572,
        "mnp": 29,
        "sms": 0,
        "usage_eur": 5.8725,
        "voice": 0
    },
    {
        "country": "LI",
        "inbound": 0,
        "hlr": 6,
        "mnp": 12,
        "sms": 15,
        "usage_eur": 1.331,
        "voice": 0
    },
    {
        "country": "US",
        "inbound": 4,
        "hlr": 2,
        "mnp": 0,
        "sms": 10,
        "usage_eur": 0.8,
        "voice": 0
    },
    {
        "country": "PL",
        "inbound": 8,
        "hlr": 20
        "mnp": 0,
        "sms": 8,
        "usage_eur": 0.6,
        "voice": 0
    }
]

Beispiel 3

Abfrage der Statistiken gruppiert nach Subaccount.

Anfrage:
https://gateway.sms77.io/api/analytics?p=api-schlüssel&group_by=subaccount

Antwort:

[
  {
    "account": "Max Mustermann",
    "hlr": 17,
    "inbound": 1,
    "mnp": 17,
    "sms": 74,
    "usage_eur": 6.7125,
    "voice": 12
  }
]

Beispiel 4

Abfrage der Statistiken gruppiert nach Label. Ist der Wert label eine leere Zeichenkette, so entspricht dieses Objekt allen Nachrichten, wo kein Label gesetzt ist.

Anfrage:
https://gateway.sms77.io/api/analytics?p=api-schlüssel&group_by=label

Antwort:

[
  {
    "label": "TestLabel",
    "sms": 60,
    "voice": 0,
    "hlr": 0,
    "mnp": 0,
    "inbound": 0,
    "usage_eur": 4.5
  },
  {
    "label": "",
    "sms": 14,
    "voice": 12,
    "hlr": 17,
    "mnp": 17,
    "inbound": 1,
    "usage_eur": 2.2125
  }
]