Criar 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 criar cartões oferece uma maneira eficiente e automatizada de inserir, atualizar e gerenciar essas unidades de trabalho diretamente a partir das suas aplicações ou sistemas existentes, aumentando a produtividade e integridade dos processos.

Para criar 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.

Veja também: Autenticação

Como os fluxos no Cange possuem campos dinâmicos, simplificamos o processo para você. Na tela de configuração do formulário, oferecemos uma opção prática para copiar o objeto do body da requisição completa. Basta abrir a tela de edição do formulário inicial e, abaixo da pré-visualização do formulário, você encontrará um contêiner com a informação "Objeto API". Copie esse objeto e use-o como base para montar sua solicitação de criação de um cartão, garantindo que todos os campos dinâmicos sejam corretamente incluídos.

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

https://api.cange.me/form/new-answer

POST /form/new-answer

Endpoint com o objetivo de criar um novo cartão dentro de um fluxo

Headers

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

Body

Name	Type	Description
`id_form`	number	Código identificador do formulário
`origin`	string	Identificação do local que está partindo a solicitação
`values`	object	Objeto com os campos do formulário e seu valor para inserção (Este objeto pode ser copiado na tela do formulário)
`flow_id`	number	Código identificador do fluxo

{
  "id_form": 662,
  "origin": "/NomeDaSuaApi",
  "values": {
    "7daf17bab5e0a7aa44417ee84ae2f705cd828766": "ReplaceByYourValue",
    "318b58166fff4affec4e0b700caa96b02d5ffefa": "ReplaceByYourValue",
    "50b2e145782d65231f45306ff10cda5a7ea2d1cd": "ReplaceByYourValue",
    "b7ce18bc7da2452724ae4b27bb9f0ff66bbbf6b7": "ReplaceByYourValue"
  },
  "flow_id": 192
}

Resposta (200)

{
    "form_id": 35627,
    "user_id_creator": 230,
    "dt_created": "2023-09-06T14:11:07.000Z",
    "company_id": 215,
    "origin": "/Sistemalegado",
    "flow_step_id": 28347,
    "card_id": 82810,
    "id_form_answer": 379344,
    "dt_deleted": null,
    "form_answer_fields": [
        {
            "form_answer_id": 379344,
            "field_id": 91184,
            "index": 0,
            "value": "teste",
            "dt_created": "2023-09-06T14:11:07.000Z",
            "dt_last_update": "2023-09-06T14:11:07.000Z",
            "id_form_answer_field": 2402985,
            "dt_deleted": null
        }
    ]
}