5 min de leituraAtualizado em 2026-09-07
Guia de Início Rápido (Quickstart)
Bem-vindo à **Tarevo Public Partner API V1**. Em menos de 10 minutos você realizará sua primeira chamada real com dados de teste.
1. Acesse o Console de Desenvolvedores
1. Faça login em [developers.tarevo.com.br/login](https://developers.tarevo.com.br/login).
2. Crie uma aplicação ou use a aplicação padrão criada durante o seu cadastro.
3. Acesse a aba **Sandbox** da sua aplicação.
2. Provisione sua Loja de Testes
No painel Sandbox da aplicação, clique em **Provisionar Loja de Teste**. O Tarevo criará automaticamente um estabelecimento sandbox isolado (ex: `TL7K9A`) pré-configurado com categorias, produtos e clientes.
3. Obtenha seu Token de Acesso (OAuth 2.0)
Envie uma requisição HTTP POST para o endpoint de autenticação:
curl -X POST https://api.tarevo.com.br/partner/auth/token \
-H "Content-Type: application/json" \
-d '{
"grant_type": "client_credentials",
"client_id": "SEU_CLIENT_ID_SANDBOX",
"client_secret": "SEU_CLIENT_SECRET_SANDBOX"
}'Resposta de sucesso:
{
"access_token": "eyJhbGciOi...",
"token_type": "Bearer",
"expires_in": 3600,
"scope": "orders:read catalog:read merchant:read webhooks:manage",
"tenant_id": "TL7K9A",
"environment": "SANDBOX"
}4. Consulte os Dados da Loja
Com o token em mãos, faça a primeira chamada para ler os dados da loja:
curl -X GET https://api.tarevo.com.br/public/v1/store \
-H "Authorization: Bearer eyJhbGciOi..."