API
Ένα καλούμενο endpoint του έργου, εσωτερικό μέσω call_project_api ή εξωτερικό μέσω του endpoint api/mcp.
Ένα πρόγραμμα API είναι ένα επίπεδο ενορχήστρωσης με μία έξοδο: μπορεί να δεσμεύσει μια πηγή δεδομένων, να συντονίσει κλήσεις get_data, set_data και batch μέσα στα δικά του συμβάντα, και να επιστρέψει μία απάντηση, διαμορφωμένη από ένα πρότυπο και όχι από δεσμεύσεις πεδίων. Καλέστε το μέσα από το έργο με την ενέργεια ροής εργασίας call_project_api, ή φτάστε το απ' έξω μέσω του endpoint api/mcp του έργου.
Ιδιότητες
progDataSource και progFields
Ίδιο σχήμα με την Πηγή δεδομένων, που χρησιμοποιείται όταν το API διαβάζει ή γράφει έναν πίνακα ως μέρος της δημιουργίας της απάντησής του. Τα progFields δηλώνουν τα πεδία που είναι διαθέσιμα στο πρότυπο απάντησης, table για πραγματικές στήλες, virtual για υπολογιζόμενες.
scriptData: το πρότυπο απάντησης
Το περιεχόμενο είναι ένα πρότυπο αντικειμένου σε μορφή string στο scriptData.value· οι δεσμεύσεις @field επιλύονται τη στιγμή της κλήσης, με την ίδια σύνταξη εκφράσεων όπως παντού αλλού στην πλατφόρμα:
Κλήση ενός προγράμματος API
Εσωτερικά, το call_project_api το εκτελεί ακριβώς όπως το get_data ή το set_data εκτελούν τους δικούς τους τύπους προγραμμάτων, το name.prog ονομάζει το αναγνωριστικό του API, το name.parameters δίνει τις εισόδους του.
Παράδειγμα εφαρμογής
Δηλώστε τη διεπαφή
progParams για κάθε τιμή εισόδου (dir: "in") και εξόδου (dir: "out").
Δεσμεύστε δεδομένα αν τα χρειάζεται η απάντηση
Ένα προαιρετικό progDataSource, συν progFields για όποιες στήλες τροφοδοτούν το πρότυπο.
Γράψτε το πρότυπο απάντησης
Το scriptData.value, ένα αντικείμενο σε μορφή string με σημεία αντικατάστασης @field, και ορίστε το apiOutput στη μορφή που πρέπει να πάρουν πίσω οι καλούντες.
Δημιουργήστε έναν κόμβο API κάτω από τα Προγράμματα, ορίστε το apiOutput στην καρτέλα Ιδιότητες του, προαιρετικά δεσμεύστε μια Πηγή δεδομένων, και μετά γράψτε το σχήμα της απάντησης στον επεξεργαστή Απάντηση.
Το μπλοκ <response> του .xu είναι το scriptData.value, γραμμένο ως απλή έκφραση αντικειμένου και όχι ως string JSON.