API
Volateľný koncový bod projektu, interný cez call_project_api alebo externý cez koncový bod api/mcp.
Program API je orchestračná vrstva s jedným výstupom: môže viazať zdroj dát, koordinovať volania get_data, set_data a batch vo svojich udalostiach a vrátiť jednu odpoveď, tvarovanú šablónou, nie väzbami polí. Zavolajte ho zvnútra projektu akciou pracovného postupu call_project_api alebo sa k nemu dostanete zvonka cez koncový bod api/mcp projektu.
Vlastnosti
progDataSource a progFields
Rovnaký tvar ako Zdroj dát, používa sa, keď API číta alebo zapisuje tabuľku pri vytváraní odpovede. progFields deklaruje polia dostupné pre šablónu odpovede, table pre skutočné stĺpce, virtual pre vypočítané.
scriptData: šablóna odpovede
Obsah je šablóna objektu ako reťazec v scriptData.value; väzby @field sa vyhodnotia pri volaní, rovnakou syntaxou výrazov ako všade inde na platforme:
Volanie programu API
Interne call_project_api ho spustí presne tak, ako get_data alebo set_data spúšťajú svoje typy programov, name.prog pomenúva id API a name.parameters dodáva jeho vstupy.
Ukážkový príklad
Deklarujte rozhranie
progParams pre každú vstupnú (dir: "in") a výstupnú (dir: "out") hodnotu.
Viažte dáta, ak ich odpoveď potrebuje
Voliteľný progDataSource plus progFields pre stĺpce, ktoré napájajú šablónu.
Napíšte šablónu odpovede
scriptData.value, reťazec objektu so zástupnými symbolmi @field, a nastavte apiOutput na formát, ktorý majú volajúci dostať späť.
Vytvorte uzol API pod Programami, nastavte apiOutput na jeho karte Vlastnosti, voliteľne viažte Zdroj dát a potom napíšte tvar odpovede v editore Odpoveď.
Blok <response> v .xu je scriptData.value, zapísaný ako obyčajný výraz objektu, nie ako reťazec JSON.