Primeira chamada em 5 minutos

O endereço da API é https://api.taitecnologia.com. Todas as rotas aceitam e devolvem JSON.

Use um usuário de integração

A API age em nome de um usuário e herda as permissões dele. Para uma integração de sistema, crie na sua empresa um usuário dedicado, com um perfil de acesso que só tenha o que a integração precisa. Assim a integração não depende da senha de uma pessoa e pode ser desligada sem afetar ninguém.

1. Faça login com e-mail e senha.

   cURL

   curl -X POST https://api.taitecnologia.com/auth \
     -H "Content-Type: application/json" \
     -d '{"login": "integracao@suaempresa.com.br", "password": "********"}'

   JavaScript

   const resp = await fetch('https://api.taitecnologia.com/auth', {
     method: 'POST',
     headers: { 'Content-Type': 'application/json' },
     body: JSON.stringify({ login: 'integracao@suaempresa.com.br', password: '********' }),
   })
   const { token, refreshToken } = await resp.json()

   Python

   import requests
   
   resp = requests.post('https://api.taitecnologia.com/auth', json={
       'login': 'integracao@suaempresa.com.br',
       'password': '********',
   })
   resp.raise_for_status()
   token = resp.json()['token']

   A resposta traz o token (válido por 24 horas) e o refreshToken (válido por 7 dias):

   {
     "userId": 812,
     "userName": "Integração ERP",
     "login": "integracao@suaempresa.com.br",
     "token": "eyJhbGciOi…",
     "refreshToken": "q8V2+fL0x/…=",
     "impersonated": false
   }

   Se o mesmo e-mail tem conta em mais de uma empresa, o login responde 409 e pede a escolha da empresa — veja Login em mais de uma empresa.

2. Confirme quem você é e o que pode fazer.

   curl https://api.taitecnologia.com/auth/me \
     -H "Authorization: Bearer $TOKEN"

   {
     "login": "integracao@suaempresa.com.br",
     "name": "Integração ERP",
     "roles": ["CUSTOMER_EMPLOYEE"],
     "modulosHabilitados": ["CORE", "ORGANIZACAO", "PESSOAS", "PONTO"],
     "permissoes": {
       "permissoes": [
         { "funcionalidadeCodigo": "COLABORADOR", "modulo": "PESSOAS", "tipoAcesso": "EDICAO" },
         { "funcionalidadeCodigo": "PONTO", "modulo": "PONTO", "tipoAcesso": "SOMENTE_LEITURA" }
       ]
     }
   }

   modulosHabilitados são os módulos que a empresa contratou. permissoes.permissoes lista as funcionalidades do usuário e o nível de acesso a cada uma. Uma rota fora deles responde 403 — veja Empresa, permissões e módulos.

3. Liste colaboradores, com paginação.

   curl "https://api.taitecnologia.com/colaborador/page?page=0&size=20&sort=nome,asc" \
     -H "Authorization: Bearer $TOKEN"

   {
     "content": [
       { "id": 1043, "nome": "Ana Ribeiro", "emailCorporativo": "ana@suaempresa.com.br", "cargo": { "id": 77, "nome": "Analista de RH" } }
     ],
     "totalElements": 128,
     "totalPages": 7,
     "number": 0,
     "size": 20,
     "first": true,
     "last": false
   }

4. Renove o token antes de ele vencer.

   curl -X POST -G https://api.taitecnologia.com/auth/refresh \
     --data-urlencode "refreshToken=$REFRESH_TOKEN"

   O refreshToken vai na query string e precisa ser codificado (encodeURIComponent em JavaScript, params= no requests): ele contém +, / e =. A resposta tem o mesmo formato do login, com um par de tokens novo.

Próximos passos

• Entenda o padrão das rotas — ele vale para quase todos os recursos.
• Procure a operação que você precisa na referência.
• Veja o guia de cadastro de colaborador, que encadeia a estrutura organizacional.