# 4.O Que é uma API?

API (Application Programming Interface) é um conjunto de regras que permite que diferentes sistemas conversem entre si.

### 📖 Analogia: Tomada Elétrica

Uma API funciona como uma tomada elétrica. Se você tem um carregador de celular, ele pode ser conectado a qualquer tomada porque todas seguem o mesmo padrão.

Da mesma forma, uma API permite que diferentes programas se conectem e troquem informações.

Exemplo de API:

1\. Você usa um aplicativo de clima no celular.

2\. O aplicativo se conecta à API de previsão do tempo.

3\. A API responde com a temperatura e previsão do dia.

Uma API pode ser acessada com um simples comando cURL:

```bash
curl -X GET "https://api.clima.com/hoje"
```

E a resposta pode ser algo assim:

```json
{
  "cidade": "Rio de Janeiro",
  "temperatura": 28,
  "condicao": "Ensolarado"
}
```

Isso mostra que a API retorna informações úteis para serem usadas por outros sistemas.

### 🛠️ O Que São Rotas e Métodos HTTP?

Uma rota de API é um caminho específico que permite acessar um recurso dentro de um servidor.

#### <mark style="color:purple;">🔍 Analogia: Endereços de Casas</mark>

Pense nas rotas da API como endereços de casas:

• "<https://api.meusite.com/usuarios>" → Endereço onde estão os usuários.

• "<https://api.meusite.com/produtos>" → Endereço onde estão os produtos.

• "<https://api.meusite.com/pedidos>" → Endereço onde estão os pedidos.

Cada rota leva a um dado ou funcionalidade diferente dentro da API.

### 📌 Os Principais Métodos HTTP

Os métodos HTTP são como ações que podemos realizar nas rotas da API.

<table><thead><tr><th width="132.34375">Método</th><th width="274.9765625">O que faz?</th><th width="326.5234375">Exemplo de Uso</th></tr></thead><tbody><tr><td>GET</td><td>Busca dados</td><td>Ver uma lista de produtos</td></tr><tr><td>POST</td><td>Cria um novo dado</td><td>Criar um novo usuário</td></tr><tr><td>PUT</td><td>Atualiza um dado inteiro</td><td>Alterar todo um pedido</td></tr><tr><td>PATCH</td><td>Atualiza um pedaço do dado</td><td>Mudar apenas o status do pedido</td></tr><tr><td>DELETE</td><td>Remove um dado</td><td>Excluir um usuário</td></tr></tbody></table>

### 🟣 Exemplo Prático dos Métodos HTTP

Imagine que temos uma API para gerenciar usuários.

<details>

<summary>1️⃣ Buscar todos os usuários (GET)</summary>

```bash
curl -X GET "https://api.meusite.com/usuarios"
```

Aqui estamos pedindo para ver a lista de usuários cadastrados.

</details>

<details>

<summary>2️⃣ Criar um novo usuário (POST)</summary>

```bash
curl -X POST "https://api.meusite.com/usuarios" \
     -H "Content-Type: application/json" \
     -d '{
          "nome": "Maria",
          "email": "maria@email.com"
         }'
```

Criamos um novo usuário chamado Maria.

</details>

<details>

<summary>3️⃣ Atualizar um usuário (PUT - Substituir todos os dados)</summary>

```bash
curl -X PUT "https://api.meusite.com/usuarios/1" \
     -H "Content-Type: application/json" \
     -d '{
          "nome": "Maria Silva",
          "email": "maria.silva@email.com"
         }'
```

Aqui estamos substituindo todos os dados do usuário ID 1.

</details>

<details>

<summary>4️⃣ Alterar apenas o e-mail do usuário (PATCH - Atualizar parte do dado)</summary>

```bash
curl -X PATCH "https://api.meusite.com/usuarios/1" \
     -H "Content-Type: application/json" \
     -d '{
          "email": "maria.novo@email.com"
         }'
```

Atualizamos somente o e-mail do usuário ID 1, sem mexer no nome.

</details>

<details>

<summary>5️⃣ Excluir um usuário (DELETE)</summary>

```bash
curl -X DELETE "https://api.meusite.com/usuarios/1"
```

📌 Removemos o usuário com ID 1 usando a API.

</details>

Agora você sabe:

* O que são rotas e como cada uma tem um propósito específico.
* O que cada método HTTP faz e quando usá-lo.
* Como usar cURL para fazer requisições com os métodos GET, POST, PUT, PATCH e DELETE.

Esses conceitos são essenciais para usar qualquer API, incluindo a API da Zaia, que permite criar agentes de IA no-code e automatizar interações com outros sistemas.

### 🚀 Agora Você Está Pronto Para Usar a API da Zaia!

Agora que você conhece os fundamentos de JSON, Webhooks, cURL e APIs, você está pronto para explorar a API da Zaia. Com esse conhecimento, você será capaz de:

✅ Ler e interpretar respostas em JSON de forma eficiente.

✅ Configurar Webhooks para receber notificações automáticas.

✅ Usar cURL para testar chamadas e interagir com APIs.

✅ Entender como diferentes sistemas se comunicam através de APIs.

\
A API da Zaia foi criada para facilitar  automações de processos e a criação de agentes de IA no-code, permitindo integrações poderosas com diversos sistemas. Agora, é hora de começar a explorar suas funcionalidades e criar soluções incríveis!

Bem-vindo ao mundo das APIs da Zaia! 🚀 Só bora!!