Account

GET/api/balance

Guthaben

Nutzen Sie diesen Endpunkt um Ihren aktuellen Guthabenstand abzufragen. Zur Abfrage sind keine weiteren Parameter erforderlich. Die Rückgabe erfolgt als einfacher Text mit Ihrem aktuellen Guthabenstand als Floatzahl mit einem Punkt als Trennzeichen für die Nachkommastellen.

Anfrage

GET
/api/balance
curl -G https://gateway.seven.io/api/balance \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL"

Antwort

290.67
GET/api/prices

Preise

Über diesen Endpunkt können Sie die aktuellen Preise Ihres Accounts für den Versand von SMS abrufen.

Parameter

  • Name
    country
    Type
    string
    Description

    Code des Landes gemäß ISO-3166 (ALPHA-2), für welches Sie die Preise abfragen möchten. Ist dieser Parameter nicht angegeben, werden die Preise aller Länder ausgegeben.

  • Name
    format
    Type
    json|csv
    Description

    Standardmäßig werden die Daten als JSON zurückgeliefert. Sie können allerdings auch ein CSV Format anfordern. Verwenden Sie dazu den Parameter format=csv

Anfrage

GET
/api/balance
curl -G https://gateway.seven.io/api/pricing \
  -H "X-Api-Key: IHR_API_SCHLÜSSEL"

Antwort

{
    "countCountries": 1,
    "countNetworks": 4,
    "countries": [
        {
            "countryCode": "AT",
            "countryName": "Austria",
            "countryPrefix": "43",
            "networks": [
                {
                    "mcc": "232",
                    "mncs": [
                        "02"
                    ],
                    "networkName": "A1 Telekom Austria",
                    "price": 0.075,
                    "features": [],
                    "comment": ""
                },
                {
                    "mcc": "232",
                    "mncs": [
                        "01"
                    ],
                    "networkName": "A1 Telekom Austria (A1.net)",
                    "price": 0.075,
                    "features": [
                        "alpha",
                        "numeric",
                        "dlr",
                        "sc"
                    ],
                    "comment": ""
                },
                {
                    "mcc": "232",
                    "mncs": [
                        "11"
                    ],
                    "networkName": "A1 Telekom Austria (bob)",
                    "price": 0.075,
                    "features": [],
                    "comment": ""
                },
                {
                    "mcc": "232",
                    "mncs": [
                        "09"
                    ],
                    "networkName": "A1 Telekom Austria (Tele2Mobil)",
                    "price": 0.075,
                    "features": [],
                    "comment": ""
                }
            ]
        }
    ]
}

Antwort

"countryCode";"countryName";"countryPrefix";"mcc";"mncs";"networkName";"price";"features";"comment"
"AT";"Austria";"43";"232";"02";"A1 Telekom Austria";"0.075";"";""
"AT";"Austria";"43";"232";"01";"A1 Telekom Austria (A1.net)";"0.075";"alpha,numeric,dlr,sc";""
"AT";"Austria";"43";"232";"11";"A1 Telekom Austria (bob)";"0.075";"";""
"AT";"Austria";"43";"232";"09";"A1 Telekom Austria (Tele2Mobil)";"0.075";"";""
"AT";"Austria";"43";"232";"12";"A1 Telekom Austria (yesss!)";"0.075";"";""
"AT";"Austria";"43";"232";"92";"ArgoNET GmbH (ArgoNET)";"0.075";"";""
"AT";"Austria";"43";"232";"14,16,19";"Hutchison Drei Austria";"0.075";"alpha,numeric,dlr,sc";""
"AT";"Austria";"43";"232";"05,10";"Hutchison Drei Austria (3)";"0.075";"alpha,numeric,dlr,sc";""
"AT";"Austria";"43";"232";"08";"Lycamobile Austria (Lycamobile)";"0.075";"";""
"AT";"Austria";"43";"232";"17";"MASS Response Service GmbH";"0.075";"alpha,numeric,dlr,sc";""
"AT";"Austria";"43";"232";"20";"MTEL Austrija GmbH (m:tel)";"0.075";"";""
"AT";"Austria";"43";"232";"15";"Mundio Mobile Austria (Vectone Mobile)";"0.075";"";""
"AT";"Austria";"43";"232";"91";"ÖBB (GSM-R A)";"0.075";"";""
"AT";"Austria";"43";"232";"06";"Orange Austria GmbH (Orange AT)";"0.075";"";""
"AT";"Austria";"43";"232";"22";"Plintron Austria Limited";"0.075";"";""
"AT";"Austria";"43";"232";"21";"Salzburg AG für Energie, Verkehr und Telekommunikation";"0.075";"";""
"AT";"Austria";"43";"232";"18";"smartspace GmbH";"0.075";"";""
"AT";"Austria";"43";"232";"03,13";"T-Mobile Austria (T-Mobile AT)";"0.075";"alpha,numeric,dlr,sc";""
"AT";"Austria";"43";"232";"07";"T-Mobile Austria (tele.ring)";"0.075";"";""
"AT";"Austria";"43";"232";"23";"T-Mobile Austria GmbH";"0.075";"";""
"AT";"Austria";"43";"232";"04";"T-Mobile Austria GmbH (T-Mobile AT)";"0.075";"";""
GET/api/analytics

Statistiken

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

Parameter

  • Name
    start
    Type
    date
    Description

    Startdatum der Statistiken im Format JJJJ-MM-TT. Standardmäßig wird das Datum von vor 30 Tagen gesetzt.

  • Name
    end
    Type
    date
    Description

    Enddatum der Statistiken. Standardmäßig der aktuelle Tag.

  • Name
    label
    Type
    all|string
    Description

    Zeigt nur Daten eines bestimmten Labels an.

  • Name
    subaccounts
    Type
    only_main|all|integer
    Description

    Erhalten Sie die Daten nur zum Hauptaccount, zu allen Ihren (Sub-)Accounts oder nur zu spezifischen Subaccounts

    ID eines Subaccounts - Zeigt die Daten eines bestimmten Subaccounts an.
    all - Zeigt die Daten aller Accounts und Subaccounts kumuliert an. only_main - Zeigt nur die Daten des Hauptaccounts an.

  • Name
    group_by
    Type
    date|label|subaccount|country
    Description

    Legt die Gruppierung der Daten fest. Standard ist date

Anfrage

GET
/api/analytics
curl -G https://gateway.seven.io/api/analytics \
  -H "X-Api-Key: IHR_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
  }
  // ...
]