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": "2024-03-27",
    "sms": 200,
    "rcs": 6729,
    "voice": 425,
    "hlr": 5920,
    "mnp": 49,
    "inbound": 0,
    "usage_eur": 932.12
  },
  {
    "date": "2024-03-27",
    "sms": 156,
    "rcs": 5993,
    "voice": 400,
    "hlr": 2002,
    "mnp": 0,
    "inbound": 48,
    "usage_eur": 854.39
  },
  // ...
]