API
Un endpoint apelabil al proiectului, intern prin call_project_api sau extern prin endpointul api/mcp.
Un program API este un strat de orchestrare cu o singură ieșire: poate lega o sursă de date, poate coordona apeluri get_data, set_data și batch în propriile evenimente și returnează un singur răspuns, modelat de un șablon, nu de legări de câmpuri. Îl apelezi din interiorul proiectului cu acțiunea de workflow call_project_api sau îl accesezi din exterior prin endpointul api/mcp al proiectului.
Proprietăți
progDataSource și progFields
Aceeași structură ca Sursă de date, folosită când API-ul citește sau scrie un tabel ca parte din construirea răspunsului. progFields declară câmpurile disponibile pentru șablonul de răspuns, table pentru coloane reale, virtual pentru cele calculate.
scriptData: șablonul de răspuns
Conținutul este un șablon de obiect sub formă de șir în scriptData.value; legările @field se rezolvă în momentul apelului, cu aceeași sintaxă de expresii ca în restul platformei:
Apelarea unui program API
Intern, call_project_api îl rulează exact cum get_data sau set_data își rulează tipurile de program: name.prog numește id-ul API-ului, name.parameters furnizează intrările lui.
Exemplu lucrat
Declară interfața
progParams pentru fiecare valoare de intrare (dir: "in") și de ieșire (dir: "out").
Leagă date dacă răspunsul are nevoie de ele
Un progDataSource opțional, plus progFields pentru coloanele care alimentează șablonul.
Scrie șablonul de răspuns
scriptData.value, un obiect sub formă de șir cu substituenți @field, și setează apiOutput la formatul pe care trebuie să-l primească apelanții.
Creează un nod API sub Programe, setează apiOutput în fila Proprietăți, leagă opțional o Sursă de date, apoi scrie forma răspunsului în editorul Răspuns.
Blocul <response> din .xu este scriptData.value, scris ca o expresie de obiect simplă, nu ca un șir JSON.