GESTTRA
REST API · JSON · OAuth 2.0

API GESTTRA

Integre controle de ponto, marcações e People Analytics diretamente no seu sistema, com uma API REST simples e segura.

Autenticação

A API do GESTTRA utiliza OAuth 2.0 com Bearer Token. Primeiro, obtenha um token de acesso e utilize-o no headerAuthorization: Bearer <token> em todas as requisições.

Endpoint de autenticação:POST /api/v1/auth/token

Exemplo de request (cURL)

curl -X POST https://api.gesttra.com/api/v1/auth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "SEU_CLIENT_ID",
    "client_secret": "SEU_CLIENT_SECRET",
    "grant_type": "client_credentials"
  }'

Exemplo de resposta

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "scope": "read:colaboradores write:marcacoes"
}

Endpoints disponíveis

Principais recursos para integração com controle de ponto, relatórios e alertas.

MétodoEndpointDescrição
GET/api/v1/colaboradoresLista colaboradores
GET/api/v1/marcacoesLista marcações por período
POST/api/v1/marcacoesRegistra marcação manual
GET/api/v1/relatorios/espelhoEspelho de ponto
GET/api/v1/alertasLista alertas ativos
POST/api/v1/webhooksConfigura webhook de eventos

Exemplo de integração

Exemplo básico de autenticação e consulta de colaboradores usando cURL e JavaScript (fetch).

cURL

TOKEN="$(curl -s -X POST https://api.gesttra.com/api/v1/auth/token \
  -H 'Content-Type: application/json' \
  -d '{"client_id":"SEU_CLIENT_ID","client_secret":"SEU_CLIENT_SECRET","grant_type":"client_credentials"}' \
  | jq -r .access_token)"

curl -X GET https://api.gesttra.com/api/v1/colaboradores \
  -H "Authorization: Bearer $TOKEN"

JavaScript (fetch)

async function fetchColaboradores() {
  const authRes = await fetch('https://api.gesttra.com/api/v1/auth/token', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      client_id: 'SEU_CLIENT_ID',
      client_secret: 'SEU_CLIENT_SECRET',
      grant_type: 'client_credentials',
    }),
  });
  const auth = await authRes.json();

  const res = await fetch('https://api.gesttra.com/api/v1/colaboradores', {
    headers: { Authorization: `Bearer ${auth.access_token}` },
  });
  const data = await res.json();
  console.log(data);
}

SDKs e integrações prontas

Fortes RHIntegração nativa
ProtheusIntegração nativa
AsaasIntegração nativa
API RESTSistemas customizados

Rate limits e SLA da API

  • • Até 1.000 requests/minuto por organização.
  • • Uptime da API de 99,5%, monitorado 24x7.
  • • Ambiente sandbox disponível para testes e homologação.

Precisa de ajuda com a integração? contato@gesttra.com. Consulte também nossa página de segurança.

GESTTRA.