Fontes de dados

As conexões de onde vêm os dados do portal — uma API descrita por OpenAPI, um servidor MCP, um banco de dados somente leitura ou um produto Kobana do catálogo. No dashboard elas aparecem como Conectores. Não há um create genérico: cada tipo tem o seu (openapi create, mcp create, database create, catalog create), e test create experimenta uma conexão antes de salvá-la. sync enfileira a sincronização de todas as entidades da fonte, schedule define a frequência e spec troca a spec OpenAPI.

Comando	HTTP	Descrição
data-sources list	GET /v1/data_sources	Listar fontes de dados
data-sources get	GET /v1/data_sources/{id}	Consultar fonte de dados
data-sources update	PATCH /v1/data_sources/{id}	Atualizar fonte de dados
data-sources delete	DELETE /v1/data_sources/{id}	Excluir fonte de dados
data-sources authorize	POST /v1/data_sources/{id}/authorize	Autorizar fonte MCP
data-sources schedule	PUT /v1/data_sources/{id}/schedule	Agendar sincronização da fonte
data-sources spec	PUT /v1/data_sources/{id}/spec	Substituir spec da fonte
data-sources sync	POST /v1/data_sources/{id}/sync	Sincronizar fonte de dados
data-sources catalog list	GET /v1/data_sources/catalog	Listar produtos do catálogo Kobana
data-sources catalog create	POST /v1/data_sources/catalog	Conectar produto Kobana
data-sources database create	POST /v1/data_sources/database	Criar fonte de banco de dados
data-sources logs list	GET /v1/data_sources/{id}/logs	Listar log de requisições da fonte
data-sources logs get	GET /v1/data_sources/{id}/logs/{log_id}	Consultar requisição da fonte
data-sources mcp create	POST /v1/data_sources/mcp	Criar fonte MCP
data-sources openapi create	POST /v1/data_sources/openapi	Criar fonte OpenAPI
data-sources openapi analyze create	POST /v1/data_sources/openapi/analyze	Analisar spec OpenAPI
data-sources operations update	PATCH /v1/data_sources/{id}/operations/{operation_id}	Ligar ou desligar operação da fonte
data-sources test create	POST /v1/data_sources/test	Testar conexão antes de salvar

Exemplos

--params carrega parâmetros de query, de caminho e de cabeçalho (id, página, filtros, X-Workspace-Id); --json carrega o corpo da requisição; --fields limita os campos que voltam — vale a pena em todo list/get, para economizar contexto. Veja Flags globais para a referência completa.

# Listar fontes de dados
kobana dashboards data-sources list \
  --fields "id,name,kind,status,last_synced_at"

# Consultar fonte de dados
kobana dashboards data-sources get --params '{"id": "DATA_SOURCE_ID"}'

# Listar produtos do catálogo Kobana
kobana dashboards data-sources catalog list

# Conectar produto Kobana
kobana dashboards data-sources catalog create \
  --json '{"product": "billing", "environment": "production", "token": "TOKEN_DO_PRODUTO"}'

# Criar fonte MCP
kobana dashboards data-sources mcp create \
  --json '{"name": "CRM", "url": "https://mcp.example.com/mcp", "transport": "http"}'

# Sincronizar fonte de dados
kobana dashboards data-sources sync \
  --params '{"id": "DATA_SOURCE_ID"}' \
  --dry-run

# Agendar sincronização da fonte
kobana dashboards data-sources schedule \
  --params '{"id": "DATA_SOURCE_ID"}' \
  --json '{"cron": "0 */6 * * *", "timezone": "America/Sao_Paulo"}'

Próximos passos

• Entidades
• Introspecção de schema — todos os parâmetros que este recurso aceita.