---
agentTools:
  projectIndex: https://metrito.readme.io/llms.txt
---

# Iniciando com a API

Essa página irá te ajudar a utilizar a API Oficial do Metrito.

# **Bem-vindo à documentação da API Oficial do Metrito!**

Essa API foi desenvolvida para facilitar a análise e integração de métricas de marketing e vendas. Com ela, você pode acessar dados valiosos, como valor gasto, compras, lucro, ROAS, margem etc. Além integrá-los com suas aplicações para criar soluções personalizadas e poderosas.

***

## 📚 O que você encontrará nesta documentação?

* **Visão geral da API:** Como a API do Metrito funciona e suas principais funcionalidades.
* **Autenticação:** Como realizar login e usar o token de usuário para acessar os endpoints.
* **Endpoints disponíveis:** Detalhes sobre os endpoints e suas funções.
* **Exemplos de uso:** Exemplos práticos para te ajudar a começar rapidamente.
* **Melhores práticas:** Recomendações para otimizar o uso da API.

***

## 🚀 Como começar?

Siga os passos abaixo para começar a usar a API do Metrito:

### 1. Crie uma conta no Metrito

Se você ainda não possui uma conta, [clique aqui](https://beta.metrito.com/register?utm_source=readme\&utm_medium=api_docs\&utm_campaign=signup_redirect\&utm_content=register_cta) para criar uma gratuitamente.

### 2. Obtenha um token de usuário

Para consumir a API, você deve realizar o login no endpoint `/login` e obter um **token de usuário**, que será usado para autenticar todas as demais requisições.

#### Passo a passo:

1. Faça uma requisição POST para o endpoint `/login` enviando as credenciais de acesso (e-mail e senha).
2. Receba no retorno o token de autenticação.
3. Inclua o token no cabeçalho das requisições subsequentes, no formato:

`Authorization: Bearer {seu_token}`

> **Nota:** O token é confidencial e deve ser armazenado com segurança. Não o compartilhe publicamente.

### 3. Configure sua aplicação

Certifique-se de que sua aplicação esteja pronta para consumir a API. A API do Metrito segue o padrão **REST** e responde com dados no formato **JSON**.

#### Requisitos:

* Biblioteca HTTP, como Axios, Fetch ou cURL.
* Linguagem de programação compatível (Node.js, Python, etc.).
* Credenciais de acesso para o login e um token válido.

***

## 🌐 URL Base da API

Todas as requisições devem ser feitas para a seguinte URL base:\
**`https://api.metrito.com`**