Pular para o conteúdo
Guias / Guides

Primeira requisição

Liste seus espaços, crie uma tarefa e pagine resultados

Com o token em mãos, faça estas três chamadas para conhecer a API.

1. Liste seus espaços

Os espaços organizam as tarefas e os projetos no Wiboor. Comece por eles: a resposta traz o id de cada espaço e os usuários que participam com você.

Terminal
curl "https://api.azzimuti.com.br/v1/departments" \
  -H "Authorization: Bearer SEU_TOKEN"

Veja todos os campos em Listar espaços.

2. Crie uma tarefa

Use o id de um espaço e o id de um membro (o executor) para criar uma tarefa:

Terminal
curl -X POST "https://api.azzimuti.com.br/v1/tasks" \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Retornar contato do lead ACME",
    "type": "TASK",
    "departmentId": "ID_DO_ESPACO",
    "userExecutorId": "ID_DO_EXECUTOR"
  }'
  • Só title, type e userExecutorId são obrigatórios.
  • Para planejar a tarefa, envie startedAt (início) e endedAt (prazo) em ISO 8601, por exemplo 2026-12-01T12:00:00.000Z. O início não pode estar no passado: a API responde 400.
  • Os demais campos (prioridade, descrição, projeto…) estão em Criar uma tarefa.
  • type é TASK (tarefa) ou BUG (problema).

3. Liste tarefas com filtros e paginação

Terminal
curl -G "https://api.azzimuti.com.br/v1/tasks" \
  -H "Authorization: Bearer SEU_TOKEN" \
  --data-urlencode "userExecutorId=ID_DO_EXECUTOR" \
  --data-urlencode "status[]=NOT_STARTED" \
  --data-urlencode "status[]=STARTED" \
  --data-urlencode "count=50" \
  --data-urlencode "page=1"

As listagens são paginadas: count define quantos itens vêm por página e page escolhe a página. A resposta traz o campo pagination para você saber se há mais páginas.

Todos os filtros (busca, projeto, espaços, período, status) estão em Listar tarefas.

Próximos passos