Saltar para o conteúdo
Verificado

Plataforma de desenvolvimento

Crie um projeto, escreva os seus programas do Studio, leia e escreva as suas tabelas e publique uma versão.

Esta é a superfície de API mais ampla que a Xuda publica, 71 métodos em três microserviços, e é o que permite a uma ferramenta externa, ao seu próprio backend ou a um agente de IA através de MCP fazer o mesmo trabalho que uma pessoa faz no Studio: criar um projeto, escrever os seus programas, ler e escrever as suas tabelas, verificar uma compilação e publicar uma versão numerada.

Escrever um programa do Studio

Os quatro métodos por trás do próprio editor do Studio são exatamente os que um autor de chamadas de API utiliza, pelo que um nó criado através da API é idêntico a um criado manualmente.

Crie o projeto

create_project inicia uma nova aplicação apenas com um nome.

Crie um nó

create_prog cria um novo nó do studio a partir de um menu_type de doze: table, component, folder, globals, get_data, set_data, batch, alert, javascript, route, api ou ai_agent, utilizando a mesma fábrica que o próprio Studio utiliza.

Valide antes de guardar

validate_prog executa o verificador da própria Xuda, estrutura, referências cruzadas, ações de fluxo de trabalho, expressões, mais uma pesquisa de armadilhas para erros típicos de IA (uma aspa solta dentro de xu-script, um manipulador xu-on: que não é um array). Não escreve nada, pelo que o pode chamar as vezes que quiser.

Guarde

save_prog recompila e persiste o nó. get_prog lê um de volta, incluindo o _rev de que um save_prog seguinte precisa.

curl -s https://xuda.ai/cpi/create_prog \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","app_id":"YOUR_APP_ID","menu_type":"table","menu_name":"Orders"}'
const res = await fetch('https://xuda.ai/cpi/create_prog', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    app_id: 'YOUR_APP_ID',
    menu_type: 'table',
    menu_name: 'Orders',
  }),
});
const { code, data } = await res.json();
import requests

res = requests.post(
    'https://xuda.ai/cpi/create_prog',
    json={'api_key': 'YOUR_API_KEY', 'app_id': 'YOUR_APP_ID', 'menu_type': 'table', 'menu_name': 'Orders'},
)
Pergunte antes de escrever

get_studio_guide devolve o guia de criação por tópico e get_prog_examples pesquisa exemplos práticos por padrão ou tipo de nó. Um agente de IA que escreve através de MCP chama-os primeiro, e o mesmo texto do guia é fornecido como as próprias instructions do servidor MCP.

Ler e escrever dados de tabelas

dbs_read, dbs_create, dbs_update, dbs_delete e dbs_restore operam nas linhas de uma tabela através do seu table_id (o próprio _id do nó da tabela, nunca o seu nome de apresentação), e get_table_counts lê as contagens de linhas ativas e arquivadas. São os mesmos métodos que um programa javascript ou api chama em tempo de execução através de xu.dbs_read(...), consulte Xuda JavaScript Framework para essa perspetiva sobre os mesmos métodos.

Compilar e publicar

build_app verifica e compila uma versão numerada (clearance developer), get_app_releases lista as versões anteriores, e get_release_note_info e delete_release completam o ciclo de vida das versões.

Operações de projeto e de aplicação

Para além da criação, get_app_info, get_app_config, turn_app_on / turn_app_off, update_domain_setup, save_deploy_settings e os interruptores de visibilidade e de marca da aplicação cobrem o próprio ciclo de vida de um projeto. As famílias de ficheiros e SSH de VPS (vps_fs_*, vps_ssh_*) estão neste mesmo microserviço, consulte VPS externo e VPS Full Stack para esse lado.

Métodos