Tools do Toggl Track
As 13 operações do Toggl Track que o seu produto executa na conta do cliente pelo Connect. Todas usam o mesmo endpoint, POST /api/tools/{tool}/execute.
- Listar projetosGETLista os projetos de todos os workspaces do usuário, com id, workspace_id, client_id e nome do cliente, flag billable e status. É daqui que vêm os ids de workspace. Esta rota conta nas 30 requisições por hora que o Toggl dá a cada usuário para rotas de nível de usuário, em qualquer plano.
- Listar clientesGETLista os clientes de todos os workspaces do usuário, com id, nome, notas, flag archived e o id do workspace em wid. Esta rota conta nas 30 requisições por hora que o Toggl dá a cada usuário para rotas de nível de usuário, em qualquer plano.
- Criar clientePOSTCria um cliente em um workspace. Exige name.
- Criar projetoPOSTCria um projeto em um workspace, opcionalmente para um cliente. Exige name. Billable é um recurso pago.
- Atualizar projetoPUTAtualiza os campos enviados de um projeto e mantém os demais. Arquivar um projeto é active false.
- Listar registros de tempoGETLista os registros de tempo mais recentes do usuário conectado, até 1000. Para uma janela, envie start_date e end_date juntos; para períodos inteiros ou outras pessoas, use Obter relatório resumido. Esta rota conta nas 30 requisições por hora que o Toggl dá a cada usuário para rotas de nível de usuário, em qualquer plano.
- Obter registro de tempo atualGETRetorna o registro de tempo em andamento do usuário conectado, com seu id, ou null quando não há timer rodando. Esta rota conta nas 30 requisições por hora que o Toggl dá a cada usuário para rotas de nível de usuário, em qualquer plano.
- Criar registro de tempoPOSTCria um registro de tempo para o usuário conectado. Exige workspace, workspace_id, created_with e start. Para um timer em andamento, envie duration -1; para trabalho passado, envie duration em segundos ou stop.
- Atualizar registro de tempoPUTAtualiza os campos enviados de um registro de tempo e mantém os demais. Exige workspace e workspace_id. Mudar start ou stop muda a duração.
- Parar registro de tempoPATCHPara agora um registro de tempo em andamento.
- Excluir registro de tempoDELETEExclui um registro de tempo.
- Obter relatório resumidoPOSTRetorna o tempo registrado de um workspace em um período, em segundos, agrupado por projeto, cliente ou usuário e subagrupado, para todos que o usuário pode ver. Exige start_date. Os grupos e subgrupos trazem ids, cujos nomes vêm de Listar projetos e Listar clientes.
- Obter usuário conectadoGETRetorna o usuário conectado: id, fullname, email, timezone e default_workspace_id, o workspace que Criar cliente, Criar projeto e as ferramentas de registro de tempo pedem quando a conta ainda não tem projeto nem cliente. Conta na cota fixa de 30 chamadas por hora das rotas de usuário. O campo api_token da resposta volta mascarado.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
