Naar de inhoud springen

CMS

Tabellen met inhoud die je sites en apps lezen.

CMS openen
Gecontroleerd aan de hand van het dashboard op 18 november 2026

Een CMS-tabel is een gewone tabel in de database van de werkruimte. Je beheert tabellen met de CMS-methoden, en je leest en schrijft hun records met de recordmethoden. Elke aanroep is een POST naar /cpi/<method> met een JSON-body die je API-sleutel bevat.

bash
curl -X POST https://xuda.ai/cpi/get_cms_tables \
  -H 'content-type: application/json' \
  -d '{"api_key": "YOUR_API_KEY", "workspace_id": "YOUR_WORKSPACE_ID"}'

Het antwoord bevat elke tabel met zijn velden en het aantal records, en de database waarin hij staat (de app_id die de recordmethoden nodig hebben).

Vanuit het dashboard

Elke tabel heeft een API-venster: druk op API en JSON op een kaart of in een geopende tabel. Het toont de vijf recordaanroepen voor die tabel, de eigen velden van de tabel als JSON, hetzelfde verzoek als cURL of JavaScript, en een plek om het te versturen. De sleutelkiezer toont de sleutels die de werkruimte bereiken, en kan een nieuwe maken. Een sleutel met volledige toegang werkt. Een aangepaste heeft dbs_read nodig om te lezen en dbs_create, dbs_update en dbs_delete om te schrijven.

Records

De vijf aanroepen van het venster voeren deze methoden uit. Elke krijgt de app_id van de werkruimtedatabase en de id van de tabel.

Een record is een object waarvan de sleutels de veld-id's van de tabel zijn. Stuur table_data als array om meerdere records tegelijk toe te voegen. Verwijderen verplaatst records naar Gearchiveerd, en dbs_restore met dezelfde id's brengt ze terug. Voeg permanent toe om ze definitief te verwijderen.

POST/cpi/dbs_read
user_access

DBS Read

Reads records from an app table with optional row range, single-row lookup, sorting, filtering, and archived-record selection.

POST/cpi/dbs_create
admin

DBS Create

Creates a new record in the specified app table from the provided key-value table data.

POST/cpi/dbs_update
admin

DBS Update

Replaces the data of an existing record, identified by row_id, in the specified app table.

POST/cpi/dbs_delete
admin

DBS Delete

Soft-deletes (or permanently deletes when 'permanent' is set) the listed record IDs from an app table.

POST/cpi/dbs_restore
admin

DBS Restore

Restores previously soft-deleted records, identified by their IDs, in the specified app table.

Tabellen

POST/cpi/get_cms_tables
user

Get CMS Tables

The CMS tables of one workspace, active and archived, each with its fields and how many records it holds, plus the database the records live in (the app_id to hand dbs_read, dbs_create, dbs_update, dbs_delete and dbs_restore), whether that database is ready, and the plan with what it allows. The first open of a workspace other than Main installs the database plugin there and answers preparing until it is ready.

POST/cpi/get_cms_table
user

Get CMS Table

One CMS table as Xuda Studio stores it (its fields and indexes), with its record count and the database it lives in.

POST/cpi/save_cms_table
user

Save CMS Table

Create a CMS table, or change one when table_id is sent. A table has a name, an optional description and its fields, each a name, a type (string, number, boolean, date, array, object, or relation) and whether it is required. A relation field relates the table to the Contacts module ({ kind: 'module', module: 'contacts' }) or to another CMS table of the workspace ({ kind: 'table', table_id }), holding one id or, with many, several; a saved relation keeps what it relates to and its shape. Field names start with a letter and use letters, digits and underscores. A new table counts against the plan's tables, and every table against its fields per table. The table is an ordinary Xuda Studio table in the workspace's database, so it opens in Studio too.

POST/cpi/archive_cms_table
user

Archive CMS Table

Archive a CMS table (it leaves the list and its records stay) or bring it back with archived false, which counts against the plan's tables again.

POST/cpi/cms_related_records
user

Get CMS Records Of An Item

The CMS tables related to one item of another module (a ticket, a delivery, an order, a product, a finance document or a contact), each with its fields and the records that point at that item, so the item can show them to fill. A workspace with CMS switched off answers no tables.

Een nieuwe tabel telt mee voor de tabellen van je abonnement, elke tabel voor zijn velden, en het toevoegen of herstellen van records voor zijn records. Een aanroep voorbij een limiet wordt geweigerd met een bericht dat zegt welke.

Hoe vind je deze gids?

Laatst bijgewerkt op 19 november 2026