Documentação da API

Conectando e Trabalhando com a API do Shifton

O API do Shifton oferece acesso a todas as funcionalidades principais da plataforma — desde o gerenciamento de horários às integrações com sistemas de RH, folha de pagamento, e sistemas de análise.
Ao usar a API, você pode automatizar processos e conectar o Shifton com os serviços internos da sua empresa.

Documentação da API

Oferecemos duas versões da nossa documentação:

• 📄 Documentação Antiga — a versão anterior da referência da API (ainda suportada para integrações existentes):
  👉 https://api2.shifton.com/docs/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/en/v1/

• 🚀 Documentação Nova — a versão atual da API com uma estrutura atualizada e os métodos mais recentes:
  👉 https://api2.shifton.com/openapi/?_gl=1*1p5sxoh*_gcl_au*NTAxMjY4NzA0LjE3NTcwNzUzMjAuMTI5NjMwODcwMS4xNzU4MjcxOTkzLjE3NTgyNzE5OTI.*_ga*NTE5MDI0OTM2LjE3NTcwNzUzMjA.*_ga_1M7TJQ7HY8*czE3NTg2MjA4MDUkbzU1JGcxJHQxNzU4NjIwOTE5JGo2MCRsMCRoNjU1OTcyMjMw#/

Primeiros Passos

Obter uma Chave de API

Nas configurações da sua empresa na plataforma Shifton, gere uma chave de API.
A autorização é feita via o cabeçalho:

Faça Sua Primeira Solicitação

Por exemplo, para recuperar uma lista de funcionários:

Exemplo de resposta:

Integre a API aos Seus Fluxos de Trabalho

• Crie e modifique turnos automaticamente

• Gerencie pedidos de férias e licenças médicas

• Exporte dados para sistemas de folha de pagamento

• Construa dashboards e relatórios personalizados

Capacidades da API Principal

• Funcionários – adicionar, editar e gerenciar funções

• Horários – criar, ajustar turnos, planejar trabalho

• Folgas & Ausências – gerenciar solicitações de férias e licenças médicas

• Relatórios – exportar dados de tempo, folha de pagamento e presença

Códigos de Erro

A API do Shifton usa códigos de status HTTP:

• 200 — Solicitação bem-sucedida

• 201 — Objeto criado com sucesso

• 400 — Parâmetros inválidos

• 401 — Erro de autorização (chave API inválida)

• 403 — Acesso negado

• 404 — Recurso não encontrado

• 500 — Erro do servidor

Dicas de Uso

• Sempre utilize a nova versão da API para novas integrações

• Use Postman ou curl para testar

• Respeite os limites de taxa para evitar ser bloqueado

• Atualize as integrações que ainda dependem da documentação antiga