API - SISTEMA | BAILEYS | OFIC...
Tarefas
13 min
autenticação todas as requisições devem incluir o token do whatsapp no header authorization bearer seu token whatsapp endpoints disponíveis 1\ listar tarefas get /api/tasks/list lista todas as tarefas da empresa query parameters (opcionais) userid filtrar tarefas de um usuário específico priority filtrar por prioridade high , medium , low status filtrar por status pending , completed exemplo curl x get "https //seu dominio com/api/tasks/list?status=pending\&priority=high" \\ h "authorization bearer seu token" resposta \[ { "id" 1, "title" "tarefa exemplo", "description" "descrição da tarefa", "priority" "high", "status" "pending", "duedate" "2024 12 31t00 00 00 000z", "companyid" 1, "createdby" 5, "assignedto" 10, "creator" { "id" 5, "name" "joão silva", "email" "joao\@email com" }, "assignee" { "id" 10, "name" "maria santos", "email" "maria\@email com" }, "createdat" "2024 11 20t10 00 00 000z", "updatedat" "2024 11 21t15 30 00 000z" } ] 2\ obter status de tarefa get /api/tasks/\ id/status retorna informações e status de uma tarefa específica parâmetros id id da tarefa (na url) exemplo curl x get "https //seu dominio com/api/tasks/15/status" \\ h "authorization bearer seu token" resposta { "id" 15, "title" "tarefa exemplo", "status" "pending", "priority" "high", "duedate" "2024 12 31t00 00 00 000z", "createdby" 5, "assignedto" 10, "creator" { "id" 5, "name" "joão silva", "email" "joao\@email com" }, "assignee" { "id" 10, "name" "maria santos", "email" "maria\@email com" }, "createdat" "2024 11 20t10 00 00 000z", "updatedat" "2024 11 21t15 30 00 000z" } 3\ criar tarefa post /api/tasks/create cria uma nova tarefa body (json) title (obrigatório) título da tarefa createdby (obrigatório) id do usuário criador description (opcional) descrição da tarefa priority (opcional) prioridade high , medium , low (padrão medium ) duedate (opcional) data de vencimento (iso 8601) assignedto (opcional) id do usuário responsável exemplo curl x post "https //seu dominio com/api/tasks/create" \\ h "authorization bearer seu token" \\ h "content type application/json" \\ d '{ "title" "nova tarefa via api", "description" "descrição da tarefa", "priority" "high", "createdby" 5, "assignedto" 10, "duedate" "2024 12 31t23 59 59 000z" }' resposta (201) { "id" 20, "title" "nova tarefa via api", "description" "descrição da tarefa", "priority" "high", "status" "pending", "duedate" "2024 12 31t23 59 59 000z", "companyid" 1, "createdby" 5, "assignedto" 10, "sharedwith" \[], "creator" { "id" 5, "name" "joão silva", "email" "joao\@email com" }, "assignee" { "id" 10, "name" "maria santos", "email" "maria\@email com" }, "createdat" "2024 11 22t10 00 00 000z", "updatedat" "2024 11 22t10 00 00 000z" } 4\ finalizar tarefa post /api/tasks/\ id/complete marca uma tarefa como concluída (status = completed ) parâmetros id id da tarefa (na url) exemplo curl x post "https //seu dominio com/api/tasks/15/complete" \\ h "authorization bearer seu token" resposta { "id" 15, "title" "tarefa exemplo", "status" "completed", "priority" "high", "companyid" 1, "createdby" 5, "assignedto" 10, "creator" { "id" 5, "name" "joão silva", "email" "joao\@email com" }, "assignee" { "id" 10, "name" "maria santos", "email" "maria\@email com" }, "updatedat" "2024 11 22t14 30 00 000z" } códigos de resposta código significado 200 sucesso 201 criado com sucesso 400 requisição inválida (parâmetros faltando) 401 token inválido ou não autorizado 404 recurso não encontrado 500 erro no servidor notas importantes token use o token da tabela whatsapps (mesmo token usado nas apis de mensagens) escopo as operações são limitadas à empresa do token ids de usuários devem pertencer à mesma empresa formato de data use iso 8601 ( yyyy mm ddthh\ mm\ ss sssz )
