Docs/Introdução/quickstart
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..."

5. Próximos Passos

  • [Consultar e listar pedidos](/docs/orders)
  • [Cadastrar endpoints de Webhooks](/docs/webhooks)
  • [Conhecer a política de Rate Limiting](/docs/rate-limits)