Ir para o conteúdo

Início

Visão geral

Atenção

A API Devino pode mudar. Parâmetros de solicitação ou parâmetros de resposta opcionais podem ser adicionados aos métodos.

A documentação contém uma descrição dos serviços API para enviar e receber SMS, VIBER, EMAIL, WHATSAPP notificações, PUSH.

Cada seção inclui:

  • descrição do esquema para trabalhar com a API,
  • descrições detalhadas dos parâmetros de solicitação,
  • exemplos de pedidos.

A documentação é destinada a desenvolvedores que desejam adicionar a capacidade de interagir com serviços de envio de mensagens SMS, mensagens VIBER e notificações PUSH para as páginas de seus sites ou aplicativos.

Para começar a usar a API:

  • faça o registo da sua Conta pessoal,
  • concluir um acordo,
  • leia a documentação na qual você está interessado,
  • enviar solicitações para https://api.devino.online.

Autorização

Métodos de autorização

Todas as solicitações de API requerem autenticação. Você precisa definir o cabeçalho HTTP Authorization, que deve incluir o tipo e as credenciais.

Authorization: <type> <credentials>

Devino API suporta dois tipos de autorização:

  • Chave API - gera uma chave API.
  • Básico - é uma combinação de nome de usuário e senha, codificado em Base64.

Chave API

A chave API é o tipo de autorização mais flexível e seguro. As chaves de API podem ser limitadas num campo de ação e cobrir apenas alguns métodos de API, e podem ser revogadas a qualquer momento. Isso torna as chaves de autorização adequadas para partilhar direitos de acesso à API em vários aplicativos.

Para obter a chave API, você precisa:

  • registar-se na sua Conta pessoal
  • entre em contato com a empresa ou contate o suporte técnico
  • uma chave API exclusiva será gerada e enviada por e-mail especificado durante o registro na conta pessoal.
Authorization: Key YWxhZGRpbjpvcGVuc2VzYW1l

Básico

Tipo de autorização básica, pode ser usado em situações onde uma chave de API não está disponível. Nesse caso, o cabeçalho de autorização é uma combinação de nome de usuário e senha de sua conta pessoal na codificação Base64.

Criação de um cabeçalho de autenticação:

  • O nome de usuário e a senha são concatenados usando dois pontos (:) como separador de login:senha.
  • A string resultante é codificada usando Base64.
  • A string codificada é adicionada após o tipo "Básico".
Authorization:  Basic YWxhZGRpbjpvcGVuc2VzYW1l