Models

Os models são os seus modelos. Para os endpoints em que é necessário o id do modelo (model_id), você pode buscá-los no nosso app, através da sua URL.

Nossas URLs de models possuem o formato abaixo:

https://app.kondado.com.br/models/:model_id

Consultar status de um model

Descrição

Retorna o status de um dado modelo através do seu model_id

Método

GET

Endpoint

/models/:model_id/status

Parâmetros da URL

Nenhum

Exemplo de resposta

{
     "success": true,
     "data": {
         "162": {
             "status": "active",
             "is_running": false,
             "is_active": true,
             "kubo_status_type": "operational"
         }
     }
 }

Descrição do retorno

A resposta será um JSON com o id do model como chave de um novo JSON com os campos explicados abaixo.

status

Descrição do status. Os valores possíveis são:

  • running: O modelo está executando
  • scheduled: O modelo está na fila de execução
  • active: O modelo não está executando e nem na fila, mas está ativo
  • not_active: O modelo não está executando e nem na fila e está desativado

raw_msg

Caso o modelo apresente algum problema, este campo irá vir com a descrição do erro (por exemplo, não estamos conseguindo nos conectar com o seu conector/destino)

kubo_status_type

Descreve o estado atual do modelo. Os valores possíveis são:

  • not_published: O modelo está em modo rascunho
  • rebuilding: O modelo foi alterado recentemente e não foi executado na sua nova configuração
  • operational: O modelo está estável - não está em modo rascunho e todas as alterações feitas já foram executadas

is_running

Booleano que indica se a integração está executando (status=running)

is_active

Booleano que indica se a integração está ativa (status=active) ou desativada (status = not_active)

Consultar status de um model via API Kondado

Siga estes passos para verificar o status de execução e operacional de um model de transformação de dados usando a API REST da Kondado.

1
Identifique o model_id no app da Kondado

Acesse o app da Kondado e localize a URL do seu model, que segue o formato https://app.kondado.com.br/models/:model_id. O valor após /models/ é o model_id necessário para as chamadas de API.

2
Faça uma requisição GET ao endpoint de status

Envie uma requisição GET para /models/:model_id/status. Não são necessários parâmetros adicionais na URL. Certifique-se de que sua autenticação API está configurada corretamente.

3
Interprete o campo status na resposta

Analise o JSON retornado. Os valores possíveis são: running (executando), scheduled (na fila), active (ativo sem execução) ou not_active (desativado). Verifique também is_running e is_active para confirmação booleana.

4
Verifique o kubo_status_type para situação operacional

O campo kubo_status_type indica: not_published (rascunho), rebuilding (alterado, aguardando nova execução) ou operational (estável). Models operational garantem que todas as alterações já foram processadas.

5
Investigue erros no campo raw_msg

Se o model apresentar problemas de conexão, o campo raw_msg conterá a descrição do erro — por exemplo, falha ao conectar com conectores ou destinos. Use essa informação para diagnosticar e corrigir a integração.

Perguntas frequentes

Onde encontro o model_id para usar nos endpoints da API?
Você encontra o model_id diretamente no app da Kondado. Acesse seu model e observe a URL, que segue o formato https://app.kondado.com.br/models/:model_id — o número após /models/ é o identificador necessário.
Qual a diferença entre status 'active' e kubo_status_type 'operational'?
O campo status indica a atividade imediata: active significa que o model está habilitado mas não está rodando nem na fila. Já kubo_status_type descreve a situação operacional geral: operational indica que o model está estável, sem alterações pendentes de execução. Um model pode estar active e operational simultaneamente.
O que significa o status 'rebuilding' no kubo_status_type?
O status rebuilding indica que o model foi alterado recentemente — por exemplo, mudanças na transformação de dados — e ainda não foi executado com sua nova configuração. É um estado transitório até a próxima execução bem-sucedida.
Como identifico se há problema de conexão com meu conector ou destino?
Verifique o campo raw_msg na resposta da API. Quando há falhas de conexão, esse campo retorna a descrição do erro, como dificuldade em conectar com conectores de origem ou destinos de dados. Isso permite diagnosticar rapidamente onde está a interrupção no pipeline.
O model pode estar 'running' e 'not_published' ao mesmo tempo?
Não. O status not_published indica que o model está em modo rascunho e ainda não foi publicado. Models em rascunho não entram em execução. Para que um model tenha is_running = true ou status = running, ele precisa estar publicado e ativo.

Escrito por·Publicado em 2020-09-20·Atualizado em 2026-04-25