Renderize a tela inicial do Plan em uma requisição

Uma tela inicial costuma precisar de meia dúzia de listas: contagens, suas tarefas com prazo, quadros recentes, metas, projetos, o que pede atenção e a atividade recente. GET /v1/plan/pulse/ retorna todas elas em uma requisição, e você ativa as partes mais pesadas com include.

A chamada

curl -sS "https://api.dailybot.com/v1/plan/pulse/?include=projects,attention,activity,goal_progress" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

Pela CLI (próxima versão), a mesma tela inicial com as quatro faixas:

dailybot plan tasks status --json

O que sempre vem na resposta

Campo	Use para
counts	Indicadores inteiros: open_tasks, overdue_tasks, blocked_tasks, active_boards, active_projects, active_goals, open_tasks_on_goal_linked_projects
my_preview	Suas contagens overdue e due_today e suas top_tasks
recent_boards · featured_boards	Cartões de quadros para voltar a eles
goals_preview	Metas com período e status
timeline_teaser	O que vence em breve, em uma janela curta
agent_summary	Quadros onde agentes atuam e aprovações pendentes
unread_count	Seus itens não lidos na caixa de entrada
scope	Sempre viewer_visible: tudo conta apenas o que você pode ver

Faixas opcionais

Cada token de include acrescenta uma faixa. Uma faixa que você não pede fica ausente e não tem custo:

Token	Acrescenta
projects	projects_preview: projetos ativos visíveis, com progresso e a atualização mais recente
attention	attention: suas tarefas em aberto que estão atrasadas ou bloqueadas
activity	recent_activity: os eventos mais recentes, no mesmo formato de GET /v1/plan/activity/
goal_progress	progress e projects em cada linha de goals_preview

Um token desconhecido retorna 400 invalid_filter_value.

Cada indicador aponta para a sua consulta

Quando alguém clica em um indicador, abra a lista que o reproduz:

Indicador	Consulta da lista
Em aberto	GET /v1/plan/tasks/?state=open
Atrasadas	GET /v1/plan/tasks/?due_before=<today>&state=open
Bloqueadas	GET /v1/plan/tasks/?blocked=true&state=open

Os números batem porque o indicador e a lista aplicam as mesmas regras às mesmas tarefas visíveis. As contagens são sempre inteiros sobre o que você pode ver; não existe detalhamento por pessoa.

Faça cache com ETag

A resposta traz um ETag. Envie-o de volta em If-None-Match na próxima atualização; se nada mudou, você recebe 304 Not Modified e mantém o que já tem:

curl -sS -i "https://api.dailybot.com/v1/plan/pulse/?include=projects,attention,activity,goal_progress" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" \
  -H "If-None-Match: $ETAG"

Modo tela inicial e modo saúde do quadro

O mesmo endpoint tem um segundo modo. Acrescente group_by (por exemplo, group_by=state) e ele passa a retornar um agregado de saúde do quadro: totais, throughput por semana e cycle time. Sem group_by, você sempre recebe a tela inicial descrita aqui. include vale apenas para o modo tela inicial.

Referência

• GET /v1/plan/pulse/
• GET /v1/plan/activity/
• GET /v1/plan/me/tasks/