Pular para o conteúdo principal

Primeiros Passos

Integre com o OlaClick Hub em 3 passos: autentique, obtenha um token e chame a API.

Visão geral​

1. Obtenha seu client_id e client_secret no OlaClick Hub
2. Solicite um token via OAuth 2.1 (client_credentials)
3. Use o token para chamar os endpoints da API

Passo 1: Obtenha suas credenciais​

Ao se registrar como Connector no OlaClick Hub, você recebe:

  • client_id — identifica sua aplicação
  • client_secret — sua chave secreta (exibida apenas uma vez)

Mantenha o segredo em segurança. Se for comprometido, revogue e gere um novo.

Passo 2: Solicite um token​

Para acessar os dados de uma empresa, solicite um Company Token incluindo o company_id:

curl -X POST https://public-api.olaclick.app/oauth/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials\
&client_id=YOUR_CLIENT_ID\
&client_secret=YOUR_CLIENT_SECRET\
&company_id=COMPANY_UUID"

Resposta:

{
  "access_token": "eyJhbGciOiJSUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "orders:read menu:read"
}

Para uma explicação completa dos dois tipos de token (Connector Token vs Company Token), os scopes disponíveis e os métodos de autenticação, veja o guia de Autenticação.

Passo 3: Chame a API​

Use o access_token como Bearer token em cada requisição:

curl -X GET https://public-api.olaclick.app/v1/orders \
  -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIs..."

Resposta:

{
  "data": [
    {
      "id": "ord_abc123",
      "public_id": "PE-1234567890",
      "status": "PENDING",
      "total": 2400,
      "created_at": "2026-06-20T14:30:00Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 50,
    "total": 12,
    "has_more": false
  }
}

Ciclo de vida do token​

  • Os tokens expiram após o período de expires_in (geralmente 1 hora)
  • Solicite um novo token quando o atual expirar — não solicite um novo por chamada de API

Próximos passos​