A API key método envolve o uso de chaves exclusivas para autenticar e controlar o acesso aos recursos da API, garantindo segurança e identificação do aplicativo que está realizando as requisições.
É uma forma fácil de fornecer acesso seguro de um sistema a uma Web API.
Com a API Key é muito mais simples para enviar eventos de conversão e integrar os seus formulários com o RD Station Marketing, pois as "chaves" são estáticas, curtas e não expiram. Você faz a chamada informando a API Key e pronto, obtém a resposta, sem fluxos adicionais, sem refresh, etc.
Ou seja, a chave será válida até que você revogue o seu acesso.
Por que usar Chaves de API
As APIs 1.2 e 1.3 são modelos de autenticação simples, quando comparado com o OAuth. Porém, com a API 2.0, além de recursos novos, você também poderá utilizar as Chaves de API.
As chaves de API não são tão seguras quanto a autenticação via OAuth, mas elas ajudam a identificar o aplicativo ou projeto que está chamando uma API de uma forma mais simples.
As integrações de formulário, por exemplo, contam com os recursos das APIs 1.2 e 1.3, e com a utilização das Chaves de API, você passará a ter total controle na criação, ativação e desativação dos tokens.
Bases Legais
Esse tipo de evento aceita a atualização de Bases Legais:
| Campo | Tipo | Parâmetros válidos | Descrição |
|---|---|---|---|
| category | String | communications | A única categoria aceita é "communications". |
| type | String | pre_existent_contract, consent, legitimate_interest, judicial_process, vital_interest or public_interest | Qual base legal autoriza o tratamento de dados pessoais. |
| status | String | granted or declined | Valores aceitos: "granted" para confirmar o consentimento e "declined" para indicar que o consentimento foi recusado. |
Saiba mais sobre os conceitos de Bases Legais aqui.
O que ela faz
Cria e atualiza contatos na Base de Leads, registrando um evento de conversão com campos padrão e/ou personalizados.
Casos de utilização
- Integrações de formulário de conversão;
- Sistemas internos que enviam conversões para o RD Station Marketing.
Requisitos
Para utilizar esse recurso, você precisa:
- Criar um App na Appstore do RD Station Marketing;
- Gerar a sua chave;
- E utilizar a chave na sua requisição.
Passo a passo para utilizar a API Key
Confira aqui todos os detalhes sobre:
-
Como gerar a sua API Key
-