🚧  ⚒️ (Tutorial em Construção)  

O que é uma API?

Vamos juntos entender melhor o que essa sigla significa e qual a função dela no fluxo do Karoo Bot?

Uma API (Interface de Programação de Aplicativos) é como uma linguagem que permite que diferentes programas se comuniquem entre si. Ela define regras e protocolos para essa comunicação, facilitando o acesso e uso de recursos específicos de um serviço ou aplicativo, sem a necessidade de conhecer todos os detalhes internos de como ele funciona. 💻 

Em nosso card de integração com uma API você irá se deparar com alguns termos que iremos te explicar melhor abaixo  👇 :

👉  Métodos e Host da API:


Os métodos de uma API são as ações disponíveis para interagir com ela:

  1. GET: solicita a leitura de um recurso ou informação.

  2. POST: envia dados para serem processados e/ou armazenados pelo servidor.

  3. PUT: atualiza completamente um recurso existente.
  4. PATCH: atualiza parcialmente um recurso existente.
  5. DELETE: remove um recurso existente.

O Host, por sua vez é onde será inserido o link do servidor onde ela está hospedada e disponível para acesso. Ele é identificado por meio de um endereço chamado URL (Uniform Resource Locator), que geralmente começa com "http://" ou "https://". Essa URL especifica o local exato onde a API pode ser encontrada na internet.

👉  Headers:

Já os Headers (cabeçalhos) são informações extras incluídas nas solicitações ou respostas da API. Eles fornecem detalhes sobre o tipo de informação que está sendo enviada ou recebida, como o formato dos dados, autenticação e outros detalhes importantes para o processamento da comunicação entre cliente e servidor. No caso do Karoo Bot, ao clicar em "+ Adicionar Header" será gerado automaticamente os Headers: Key (chave) e Value (valor) respectivamente. 


👉  Response:

Response (resposta) é a informação retornada pela API após receber uma solicitação. Ela contém o resultado da ação solicitada, como os dados que você pediu, mensagens de sucesso ou erro, códigos que indicam o status da operação e outros detalhes relevantes para quem fez a solicitação. Ao clicar em Testar, você pode conferir a resposta que será trazida através da API. 



No geral, uma API é uma forma padronizada de acessar e usar recursos de um serviço ou aplicativo. Ela permite que diferentes sistemas se conectem e compartilhem informações de maneira eficiente e segura. Através de uma API, é possível fazer várias coisas, como ler e gravar dados, executar operações e obter informações atualizadas em tempo real. As APIs desempenham um papel fundamental na integração de sistemas e no desenvolvimento de aplicativos e serviços mais complexos e poderosos.