Conta

GET/api/balance

Saldo

Use este endpoint para consultar seu saldo atual. Nenhum parâmetro adicional é necessário para a consulta. A resposta é retornada como texto simples com seu saldo atual como um número de ponto flutuante, usando ponto como separador decimal.

Anfrage

GET

/api/balance

curl -G https://gateway.seven.io/api/balance \
  -H "X-Api-Key: SUA_CHAVE_API"

Resposta

290.67

GET/api/pricing

Preços

Através deste endpoint, você pode obter os preços atuais da sua conta para o envio de SMS.

Parâmetros

Name
country
Type
string
Description
Código do país de acordo com ISO-3166 (ALPHA-2), para o qual você deseja consultar os preços. Se este parâmetro não for especificado, os preços de todos os países serão exibidos.
Name
format
Type
json|csv
Description
Por padrão, os dados são retornados como JSON. No entanto, você também pode solicitar um formato CSV. Para isso, use o parâmetro format=csv

Anfrage

GET

/api/pricing

curl -G https://gateway.seven.io/api/pricing \
  -H "X-Api-Key: SUA_CHAVE_API"

Resposta

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

Anfrage

GET

/api/pricing

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

Resposta

"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

Estatísticas

Obtenha estatísticas detalhadas da sua conta diretamente através da nossa API.

Parâmetro

Name
start
Type
date
Description
Data de início das estatísticas no formato AAAA-MM-DD. Por padrão, é definido a data de 30 dias atrás.
Name
end
Type
date
Description
Data de término das estatísticas. Por padrão, o dia atual.
Name
label
Type
all|string
Description
Mostra apenas dados de um rótulo específico.
Name
subaccounts
Type
only_main|all|integer
Description
Obtenha os dados apenas da conta principal, de todas as suas contas (subcontas) ou apenas de subcontas específicas
ID de uma subconta - Mostra os dados de uma subconta específica. all - Mostra os dados de todas as contas e subcontas acumuladas. only_main - Mostra apenas os dados da conta principal.
Name
group_by
Type
date|label|subaccount|country
Description
Define a agrupação dos dados. O padrão é date

Anfrage

GET

/api/analytics

curl -G https://gateway.seven.io/api/analytics \
    -H "X-Api-Key: SUA_CHAVE_API"

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