O que é a API e como a utilizar no HilltopAds?
API significa Interface de Programação de Aplicações. Em termos simples, é um conjunto de protocolos, ferramentas e métodos que permitem que diferentes aplicações de software comuniquem e interajam entre si. As APIs são normalmente utilizadas para facilitar a troca de dados e funcionalidades entre várias aplicações, plataformas e sistemas.
A API do HilltopAds é um conjunto de métodos que permite aos anunciantes interagir com a rede de anúncios HilltopAds. Funciona como uma interface de software através da qual podem ser automatizados vários processos relacionados com a gestão de campanhas publicitárias, a obtenção de dados e outras operações na plataforma.
Que métodos de pedido são utilizados?
A API HilltopAds para anunciantes suporta os métodos GET, PATCH, POST, DELETE e PUT.
O método GET permite-lhe recuperar dados sem efetuar quaisquer alterações.
O método PATCH permite-lhe atualizar os dados fornecidos no pedido.
O método POST permite-lhe criar dados.
O método DELETE permite-lhe remover dados.
O método PUT permite-lhe substituir todos os dados fornecidos no pedido.
Por favor, note que os métodos PATCH e PUT funcionam de forma semelhante, mas há uma diferença no seu funcionamento, que ficará clara através de um exemplo.
Digamos que temos os dados {A:1, B:2, C:3}. Precisamos de substituir B:2 por B:4.
O método PATCH substituirá apenas o parâmetro B. Como resultado, obteremos {A:1, B:4, C:3}.
O método PUT substituirá TODOS os parâmetros. Como resultado, obteremos {B:4}.
Como gerar uma chave de API?
Para começar a trabalhar com a API, é necessário gerar a sua chave de API. Para o fazer:
Iniciar sessão na conta pessoal HilltopAds.
Navegue até à secção A minha conta.
Em seguida, vá para o separador API.
Fornecer uma descrição para a chave da API.
Clique no botão Gerar chave de API.
Esta chave de API é um código único que associará o seu pedido de API à sua conta e permitirá que a função trabalhe especificamente com os seus dados.
Para garantir que os pedidos de API aos métodos funcionam corretamente, certifique-se de que a chave de API que gerou tem um estado Active.
