Exemplos de integração
1. Descubra o quadro e suas etapas
GET /kanban/boards
curl "$NEXTCHAT_API/kanban/boards" \
-H "Authorization: Bearer $NEXTCHAT_API_KEY"A resposta é uma lista de quadros com suas etapas em stages. Use id do quadro e da etapa nas próximas chamadas.
2. Crie um cartão
POST /kanban/boards/{id}/cards
curl -X POST "$NEXTCHAT_API/kanban/boards/ID_DO_QUADRO/cards" \
-H "Authorization: Bearer $NEXTCHAT_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: tarefa-externa-123-criar' \
-d '{
"title": "Revisar integração do cliente",
"description": "Tarefa criada pela nossa ferramenta.",
"priority": "medium"
}'Retorna 201 com o cartão criado, incluindo id e version. Sem stage_id, entra na primeira etapa aberta.
3. Edite com a versão que você consultou
PATCH /kanban/cards/{id}
curl -X PATCH "$NEXTCHAT_API/kanban/cards/ID_DO_CARTAO" \
-H "Authorization: Bearer $NEXTCHAT_API_KEY" \
-H 'Content-Type: application/json' \
-d '{"description":"Desenvolvimento iniciado.","version":1}'4. Mova para outra etapa
POST /kanban/cards/{id}/move
curl -X POST "$NEXTCHAT_API/kanban/cards/ID_DO_CARTAO/move" \
-H "Authorization: Bearer $NEXTCHAT_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: tarefa-externa-123-mover-2' \
-d '{"stage_id":"ID_DA_ETAPA","version":2}'5. Registre o resultado
POST /kanban/cards/{id}/comments
curl -X POST "$NEXTCHAT_API/kanban/cards/ID_DO_CARTAO/comments" \
-H "Authorization: Bearer $NEXTCHAT_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: tarefa-externa-123-comentario' \
-d '{"text":"Issue criada e desenvolvimento concluído."}'