Autenticação

Para autenticar-se em nossa API, você precisa de uma chave de API. Você pode criar e visualizar essa chave na seção de desenvolvedores do seu login. Saiba mais em nosso artigo de ajuda.

Criar chave de API agora

HTTP Basic Auth

Use HTTP Basic Auth com sua chave de API. A chave de API é enviada diretamente como um cabeçalho, não é necessário codificá-la em Base64.

Exemplo de requisição com HTTP Basic Auth

curl https://gateway.seven.io/api/sms \
  -H 'Authorization: basic SUA_CHAVE_API'

OAuth2 com Bearer Token

A autenticação requer que um aplicativo esteja registrado conosco e que o cliente tenha autorizado seu uso da API.

Saiba mais sobre OAuth2.0 →

Exemplo de requisição com Bearer Auth

curl https://gateway.seven.io/api/sms \
  -H 'Authorization: Bearer ACCESS_TOKEN'

Autenticação por HTTP Header

Envie sua requisição API com sua chave de API no cabeçalho X-Api-Key

Exemplo de requisição com cabeçalho x-api-key

curl https://gateway.seven.io/api/sms \
  -H 'X-Api-Key: SUA_CHAVE_API'

Obsoleto

Autenticação por parâmetro GET/POST ou usuário/senha

Como alternativa aos métodos mencionados acima, ainda suportamos a autenticação por chave de API como parâmetro GET ou POST p.

Especificamente, a transmissão via GET não é considerada segura e, portanto, não deve ser usada. Por razões de compatibilidade, a autenticação obsoleta por usuário/senha ainda é possível. Isso é fortemente desencorajado.

Mostrar detalhes
  • Name
    u
    Type
    string
    Optional
    Optional
    Description

    Seu alias de login ou seu endereço de e-mail. Deve ser fornecido se p contiver a senha de login.

  • Name
    p
    Type
    string
    Description

    Sua chave API ou sua senha de login.

Exemplos

HTTP GET com usuário/senha

curl "https://gateway.seven.io/api/endpunkt?u=IHR_LOGIN&p=IHR_PASSWORT"

HTTP GET com chave API

curl "https://gateway.seven.io/api/endpunkt?p=SUA_CHAVE_API"

HTTP POST com chave API

curl -X POST "https://gateway.seven.io/api/endpunkt" \
    -d "p=SUA_CHAVE_API"