Account

GET/api/balance

Solde

Utilisez ce point de terminaison pour interroger votre solde actuel. Aucun paramètre supplémentaire n'est requis pour la requête. Le retour est un simple texte avec votre solde actuel sous forme de nombre décimal avec un point comme séparateur pour les décimales.

Requête

GET
/api/balance
curl -G https://gateway.seven.io/api/balance \
  -H "X-Api-Key: VOTRE_CLÉ_API"

Réponse

290.67

GET/api/pricing

Tarifs

Vous pouvez utiliser ce point de terminaison pour récupérer les tarifs actuels de votre compte pour l'envoi de SMS.

Paramètres

  • Name
    country
    Type
    string
    Description

    Code pays selon ISO-3166 (ALPHA-2) pour lequel vous souhaitez interroger les tarifs. Si ce paramètre n'est pas spécifié, les tarifs de tous les pays sont affichés.

  • Name
    format
    Type
    json|csv
    Description

    Par défaut, les données sont retournées au format JSON. Cependant, vous pouvez aussi demander un format CSV. Pour cela, utilisez le paramètre format=csv

Requête

GET
/api/pricing
curl -G https://gateway.seven.io/api/pricing \
  -H "X-Api-Key: VOTRE_CLÉ_API"

Réponse

{
    "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": ""
                }
            ]
        }
    ]
}

Requête

GET
/api/pricing
curl -G https://gateway.seven.io/api/pricing?format=csv \
  -H "X-Api-Key: VOTRE_CLÉ_API"

Réponse

"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

Statistiques

Récupérez des statistiques détaillées de votre compte directement via notre API.

Paramètres

  • Name
    start
    Type
    date
    Description

    Date de début des statistiques au format YYYY-MM-DD. La date d'il y a 30 jours est définie par défaut.

  • Name
    end
    Type
    date
    Description

    Date de fin des statistiques. Le jour actuel par défaut.

  • Name
    label
    Type
    all|string
    Description

    Affiche uniquement les données pour un label spécifique.

  • Name
    subaccounts
    Type
    only_main|all|integer
    Description

    Recevoir des données uniquement pour le compte principal, pour tous vos (sous-)comptes ou uniquement pour des sous-comptes spécifiques

    ID d'un sous-compte - Affiche les données d'un sous-compte spécifique. all - Affiche les données de tous les comptes et sous-comptes de manière cumulative. only_main - Affiche uniquement les données du compte principal.

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

    Définit le groupement des données. La valeur par défaut est date

Requête

GET
/api/analytics
curl -G https://gateway.seven.io/api/analytics \
    -H "X-Api-Key: VOTRE_CLÉ_API"

Réponse

[
    {
        "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
    },
    // ...
]