Account
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
curl -G https://gateway.seven.io/api/balance \
-H "X-Api-Key: VOTRE_CLÉ_API"
Réponse
290.67
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
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
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";"";""
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
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
},
// ...
]