Sari la conținut

CMS

Tabele de conținut pe care le citesc site-urile și aplicațiile tale.

Deschide CMS
Verificat față de tabloul de bord la 18 noiembrie 2026

Un tabel CMS este un tabel obișnuit din baza de date a spațiului de lucru. Administrezi tabelele cu metodele CMS și citești și scrii înregistrările lor cu metodele de înregistrări. Fiecare apel este un POST către /cpi/<method> cu un corp JSON care poartă cheia ta API.

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"}'

Răspunsul conține fiecare tabel cu câmpurile și numărul lui de înregistrări, plus baza de date în care se află (app_id-ul pe care îl primesc metodele de înregistrări).

Din tabloul de bord

Fiecare tabel are o fereastră API: apasă API și JSON pe un card sau într-un tabel deschis. Ea arată cele cinci apeluri de înregistrări pentru acel tabel, câmpurile proprii ale tabelului ca JSON, aceeași cerere ca cURL sau JavaScript și un loc de unde s-o trimiți. Selectorul ei de chei listează cheile care ajung la spațiul de lucru și poate crea una nouă. O cheie cu acces complet funcționează. Una personalizată are nevoie de dbs_read pentru citire și de dbs_create, dbs_update și dbs_delete pentru scriere.

Înregistrări

Cele cinci apeluri ale ferestrei rulează aceste metode. Fiecare primește app_id-ul bazei de date a spațiului de lucru și id-ul tabelului.

O înregistrare este un obiect ale cărui chei sunt id-urile câmpurilor tabelului. Trimite table_data ca matrice ca să adaugi mai multe înregistrări odată. Ștergerea mută înregistrările în Arhivate, iar dbs_restore cu aceleași id-uri le readuce. Adaugă permanent ca să le ștergi definitiv.

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.

Tabele

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.

Un tabel nou se numără la tabelele planului tău, fiecare tabel la câmpurile lui, iar adăugarea sau restaurarea de înregistrări la înregistrările lui. Un apel peste o limită este refuzat cu un mesaj care spune care.

Cum ți se pare acest ghid?

Ultima actualizare: 19 noiembrie 2026