API
Volatelný koncový bod projektu, interní přes call_project_api nebo externí přes koncový bod api/mcp.
Program API je orchestrační vrstva s jedním výstupem: může navázat zdroj dat, koordinovat volání get_data, set_data a batch uvnitř svých vlastních událostí a vrátit jednu odpověď, tvarovanou šablonou, ne vazbami polí. Volejte ho zevnitř projektu pomocí akce workflow call_project_api, nebo se k němu dostanete zvenčí přes koncový bod api/mcp projektu.
Vlastnosti
progDataSource a progFields
Stejný tvar jako Zdroj dat, používá se, když API čte nebo zapisuje tabulku jako součást sestavení své odpovědi. progFields deklaruje pole dostupná šabloně odpovědi, table pro skutečné sloupce, virtual pro vypočítané.
scriptData: šablona odpovědi
Obsah je řetězcová šablona objektu v scriptData.value; vazby @field se vyhodnotí při volání, stejnou syntaxí výrazů jako všude jinde na platformě:
Volání programu API
Interně ho call_project_api spouští přesně tak, jako get_data nebo set_data spouštějí své typy programů, name.prog pojmenovává id API, name.parameters dodává jeho vstupy.
Pracovní příklad
Deklarujte rozhraní
progParams pro každou vstupní (dir: "in") a výstupní (dir: "out") hodnotu.
Navažte data, pokud je odpověď potřebuje
Volitelný progDataSource plus progFields pro sloupce, které šablonu napájejí.
Napište šablonu odpovědi
scriptData.value, řetězcový objekt se zástupnými @field, a nastavte apiOutput na formát, který mají volající dostat zpět.
Vytvořte uzel API pod Programy, nastavte apiOutput na jeho kartě Vlastnosti, volitelně navažte Zdroj dat a pak napište tvar odpovědi v editoru Odpověď.
Blok <response> v .xu je scriptData.value, zapsaný jako obyčejný výraz objektu, ne jako řetězec JSON.