---
title: Introdução à API do tForms®
slug: introducao-a-api-do-tformsr
docTags: 
createdAt: 2023-07-29T04:04:44.444Z
---

Desenvolvida com a tecnologia REST como padrão de arquitetura de acesso por protocolos HTTP a um conjunto amigável e previsível de URL.

São permitidos os métodos POST, GET, PUT ou DELETE para a manipulação dos recursos e as respostas serão sempre no formato JSON.

Para maior simplicidade, todas as chamadas são realizadas pela URL 

**ATENÇÃO**

Nossa API utiliza os próprios Códigos de Status HTTP para indicar sucesso ou falha da chamada. Em geral os códigos iniciados com 2 indicam sucesso, os iniciados com 4 indicam erro (Ex: Falta de parâmetro obrigatório) e iniciados com 5 indicam erro interno nos nossos servidores.

### Passos para integração


1- Necessário obter uma chave de conexão (**token**) ao aplicativo com a equipe técnica da TSR ou através do app tForms no menu "Integração e API".

2 - Criar a transação ou experiência, juntando todas as entidades (pesquisa, cliente, dados da experiência, parâmetros extras).

:::CtaButton{label="Transações" docId="4a6mvJRrdyZ1COqcdEoU-" openInNewTab="true"}

:::

:::CtaButton{label="Integrando o Widget" docId="p7ebYy4gkcDJoZFAyqPGi" openInNewTab="true"}

:::

:::CtaButton{label="Integrando com Webhooks" docId="NVx9y7IBks9Mb6GiAQGb9" openInNewTab="true"}

:::