Guia de introdução às APIs da Klaviyo
O que você vai aprender
Tenha uma compreensão básica de chamadas de API e de como as APIs da Klaviyo podem beneficiar sua empresa. Neste guia, você vai aprender sobre APIs REST, métodos HTTP e ferramentas de desenvolvedor para se preparar para testar as APIs do Klaviyo. Você pode fazer suas primeiras chamadas de API em apenas 10 minutos, do início ao fim. Se você já está familiarizado com chamadas de API e está pronto para testar nossas APIs, siga nosso guia sobre como usar nossas coleções do Postman.
Ao longo deste guia, vamos incluir links para um glossário quando novos termos técnicos forem apresentados. Se você tiver dúvidas sobre o significado de alguma palavra em qualquer momento do guia, confira o glossário de termos técnicos.
O que é uma API REST?
REST API é um conjunto de siglas que significa Representational State Transfer e Application Programming Interface. Esses termos podem ser entendidos de forma mais simples como solicitações estruturadas que permitem que um software se comunique com outro e troque informações entre eles. Quando você faz uma chamada de API, você está enviando uma solicitação para um servidor onde as informações ficam armazenadas e que, em seguida, retorna uma resposta contendo os dados solicitados no formato JSON (JavaScript Object Notation).
De forma mais simples, as API REST permitem que você solicite o armazenamento de dados no Klaviyo e receba esses dados em um formato legível para você e para computadores.
Uma chamada de API padrão acontece em segundos. Nos bastidores, sua chamada vai:
- Envie uma solicitação estruturada de dados pela internet para a API. As solicitações são enviadas via HTTP, um tipo básico de solicitação de rede no qual grande parte da internet se baseia.
- A API receberá a solicitação, vai processá-la e obter as informações solicitadas nos bancos de dados da Klaviyo.
- Em seguida, a API responde ao aplicativo cliente usando o formato estruturado em JSON.
- Você receberá a resposta JSON do seu aplicativo cliente.
Embora esse conhecimento seja útil para entender como a transferência de dados funciona, ele não é necessário para começar a fazer chamadas de API e obter valor do que as APIs da Klaviyo têm a oferecer. Tudo o que você precisa saber para começar a fazer suas primeiras chamadas de API será abordado nas seções a seguir.
Métodos HTTP
Os métodos HTTP são os “verbos” pelos quais suas solicitações são enviadas. Há 2 métodos HTTP que vamos abordar neste guia: GET e POST.
Embora não vamos usá-los aqui, vale observar que a maioria das APIs REST oferece suporte a métodos HTTP adicionais, como PUT, PATCH e DELETE.
GET
Uma solicitação GET pode ser mais facilmente entendida como uma solicitação de "leitura". As solicitações GET recuperam informações do ponto de extremidade da API e retornam essas informações em uma resposta formatada em JSON. Essas solicitações permitem apenas a leitura de dados, o que as torna o tipo de solicitação mais seguro, porque seus dados não podem ser modificados nem sobrescritos com esse método.
POST
Uma solicitação POST pode ser entendida de forma simples como uma solicitação de "gravação". POST permite que você crie ou adicione novos recursos. Por exemplo, uma solicitação POST para a API de Lista pode ser usada para criar uma nova lista na sua conta, enquanto uma solicitação GET pode ser usada para recuperar todas as listas disponíveis. Observe que, ao postar dados, as respostas variarão dependendo de quando o Klaviyo conseguir concluir sua solicitação.
Ferramentas necessárias
As APIs oferecem bastante flexibilidade aos seus fluxos de trabalho e não exigem que você use um aplicativo cliente específico ou uma biblioteca de linguagem para obter os resultados desejados. Como as chamadas de API são feitas usando solicitações HTTP, quase todas as linguagens de programação conseguem enviar esse tipo de solicitação nativamente ou por meio de uma biblioteca de linguagem amplamente disponível. Além disso, dependendo do seu computador e do sistema operacional, você pode usar aplicativos nativos, como o Terminal da Apple ou a Linha de comando do Windows, para fazer chamadas de API do lado do cliente. No entanto, esses aplicativos exigem conhecimento prévio de interfaces de linha de comando.
Usamos um aplicativo gratuito para web e desktop chamado Postman. O Postman tem uma variedade de recursos que facilitam configurar e enviar uma solicitação de API, inserindo o ponto de extremidade, os parâmetros e a autenticação em uma interface útil.
Teste as APIs da Klaviyo
As APIs da Klaviyo são úteis para enviar dados de outras plataformas ou servidores para contas da Klaviyo ou consultar informações em uma conta da Klaviyo. Agora que você já entende como as APIs funcionam, pode começar a testar nossas APIs para os casos de uso da sua empresa. Para ver uma lista completa das APIs disponíveis da Klaviyo, confira nossa documentação de referência de API. Siga nosso guia sobre como usar nossas coleções do Postman para fazer sua primeira chamada de API da Klaviyo.
Recursos adicionais
Recursos do portal do desenvolvedor
O portal do desenvolvedor da Klaviyo contém guias de API e documentação de referência para ajudar você a aproveitar ao máximo nossas API. Confira os recursos abaixo para começar:
- Documentação de referência da API da Klaviyo
- Guia de introdução à API Javascript
- Como configurar eventos transacionais baseados em API
Cursos do Klaviyo Developers
A Klaviyo Academy oferece cursos para desenvolvedores para ajudar você a começar a criar com as APIs da Klaviyo. Confira os cursos abaixo: