API
Een aanroepbaar eindpunt van het project, intern via call_project_api of extern via het eindpunt api/mcp.
Een API-programma is een orkestratielaag met één uitvoer: het kan een datasource binden, get_data-, set_data- en batch-aanroepen coördineren binnen zijn eigen gebeurtenissen, en één antwoord teruggeven, gevormd door een sjabloon in plaats van door veldbindingen. Roep het van binnen het project aan met de workflowactie call_project_api, of bereik het van buiten via het eindpunt api/mcp van het project.
Eigenschappen
progDataSource en progFields
Dezelfde vorm als Datasource, gebruikt als de API een tabel leest of schrijft om haar antwoord op te bouwen. progFields declareert de velden die beschikbaar zijn voor het antwoordsjabloon, table voor echte kolommen, virtual voor berekende.
scriptData: het antwoordsjabloon
De payload is een sjabloon van een object als tekst op scriptData.value; @field-bindingen worden bij de aanroep opgelost, met dezelfde expressiesyntaxis als overal elders op het platform:
Een API-programma aanroepen
Intern voert call_project_api het precies zo uit als get_data of set_data hun programmatypen uitvoeren: name.prog noemt de id van de API, name.parameters levert de invoer.
Uitgewerkt voorbeeld
Declareer de interface
progParams voor elke invoerwaarde (dir: "in") en uitvoerwaarde (dir: "out").
Bind gegevens als het antwoord ze nodig heeft
Een optionele progDataSource, plus progFields voor de kolommen die het sjabloon voeden.
Schrijf het antwoordsjabloon
scriptData.value, een object als tekst met @field-plaatshouders, en stel apiOutput in op het formaat dat aanroepers terug moeten krijgen.
Maak een API-knooppunt onder Programma's, stel apiOutput in op het tabblad Eigenschappen, bind eventueel een Datasource, en schrijf dan de vorm van het antwoord in de editor Antwoord.
Het blok <response> in .xu is scriptData.value, geschreven als een gewone objectexpressie in plaats van een JSON-tekst.