Mover um cartão

Os cartões são componentes vitais na gestão de tarefas, projetos e fluxos de trabalho dentro da plataforma Cange, permitindo uma visualização clara e organizada de todas as atividades e responsabilidades.

Usar a API do Cange para mover cartões oferece uma maneira eficiente e automatizada de mover entre etapas essas unidades de trabalho diretamente a partir das suas aplicações ou sistemas existentes, aumentando a produtividade e integridade dos processos.

Para mover um cartão através da API, você precisará ter um token de acesso. Se ainda não possui o seu token, consulte nosso guia abaixo sobre como obter o token de autenticação.

Autenticação

Com esta requisição será possível mover os cartões entre as etapas do seu fluxo. Para ter acesso aos identificadores de cada objeto, siga os passos abaixo:

flow_id

Entre no Fluxo que deseja integrar e clique no ícone ↓ ao lado do nome do fluxo para abrir o menu suspenso, nele você poderá visualizar o identificador:

id_card

Abra o cartão e clique no ícone "..." no canto superior direito para abrir o menu suspenso do cartão, nele você poderá visualizar o identificador:

to_step_id

Visualize o Kanban do seu fluxo e na etapa que desejar mover o seu cartão, clique no ícone "..." para abair o menu suspenso, nele você poderá visualizar o identificador:

Realizando a chamada para edição do cartão

POST /card/move-step

Endpoint com o objetivo de mover um cartão entre as etapas de um fluxo

Headers

Name	Value
Content-Type	application/json
Origin	https://app.cange.me
Authorization	Bearer <token de acesso>

Body

Name	Type	Description
flow_id	number	Código identificador do fluxo
id_card	number	Código identificador do cartão
to_step_id	number	Código identificador da etapa que deseja mover o cartão
complete	string (S = Sim ou N = Não)	Parâmetro opcional para definir se o cartão deve ser finalizado após a movimentação

{
    "flow_id": 5369,
    "id_card": 83456,
    "to_step_id": 28792,
    "complete": "S"
}

Response

200

{
    "id_card": 83456,
    "dt_due": "2024-10-11",
    "flow_step_id": 28792,
    "user_id": 76
}