İçeriğe geç
Doğrulandı

Uygulama verilerini sorgulayın ve yazın

Bir Studio tablosundan satır okuyun ve bir satır ekleyin; çalışma zamanının dışından, çalışan bir uygulamanın kendi çağırdığı aynı iki yöntemle.

dbs_read ve dbs_create, bir javascript veya api programının çalışma zamanında xu.dbs_read(...) ve xu.dbs_create(...) ile yaptığı aynı iki çağrıdır. Bir hesap API anahtarıyla doğrudan erişilebilir, böylece kendi arka ucunuz çalışma zamanına hiç uğramadan bir projenin Studio tablosunu okuyup yazabilir. Aynı yöntemlerin proje içi tarafı için JavaScript Framework, data_module'ün geri kalanı için Geliştirme platformu sayfasına bakın.

table_id bulma

table_id, tablo düğümünün kendi _id değeridir, hiçbir zaman görünen adı değil. menu_type: "table" ile get_progs, bir projedeki her tabloyu {_id, properties: {menuName}} çiftleri olarak listeler. Bu, okuyabildiğiniz bir adı bu iki yöntemin gereksindiği kimliğe eşlemenin en ucuz yoludur.

Yöntemler

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.

Anlatım

Bir sayfa satır okuyun

from/to bir satır aralığıdır (from ofset, to - from sayfa boyutudur) ve ikisi de isteğe bağlıdır: atlarsanız tablonun varsayılan sayfasını alırsınız. Diğer tüm süzgeçler (row_id, query, sortModel, archived) de isteğe bağlıdır.

curl -s https://xuda.ai/cpi/dbs_read \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY","app_id":"YOUR_APP_ID","table_id":"YOUR_TABLE_ID","from":0,"to":50}'
const res = await fetch('https://xuda.ai/cpi/dbs_read', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    app_id: 'YOUR_APP_ID',
    table_id: 'YOUR_TABLE_ID',
    from: 0,
    to: 50,
  }),
});
const { code, data } = await res.json();
if (code > 0) for (const row of data.rows) console.log(row.id, row.value);
import requests

res = requests.post(
    'https://xuda.ai/cpi/dbs_read',
    json={'api_key': 'YOUR_API_KEY', 'app_id': 'YOUR_APP_ID', 'table_id': 'YOUR_TABLE_ID', 'from': 0, 'to': 50},
)
body = res.json()
if body['code'] > 0:
    for row in body['data']['rows']:
        print(row['id'], row['value'])

2. Bir satır ekleyin

table_data, tablonun kendi alan kimlikleriyle anahtarlanmış düz bir nesnedir: genel adlar değil, tablo oluşturulurken Studio'nun atadığı sütun kimlikleri. Belirli bir tablonun alanlarının ne adlandırıldığından emin değilseniz önce 1. adımla bir satır okuyun.

curl -s https://xuda.ai/cpi/dbs_create \
  -H 'content-type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY",
    "app_id": "YOUR_APP_ID",
    "table_id": "YOUR_TABLE_ID",
    "table_data": { "CNT_Name": "Priya Shah", "CNT_Email": "[email protected]" }
  }'
const res = await fetch('https://xuda.ai/cpi/dbs_create', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_API_KEY',
    app_id: 'YOUR_APP_ID',
    table_id: 'YOUR_TABLE_ID',
    table_data: { CNT_Name: 'Priya Shah', CNT_Email: '[email protected]' },
  }),
});
const { code, data } = await res.json();
if (code > 0) console.log(data.id, data.rev);
import requests

res = requests.post(
    'https://xuda.ai/cpi/dbs_create',
    json={
        'api_key': 'YOUR_API_KEY',
        'app_id': 'YOUR_APP_ID',
        'table_id': 'YOUR_TABLE_ID',
        'table_data': {'CNT_Name': 'Priya Shah', 'CNT_Email': '[email protected]'},
    },
)
body = res.json()
if body['code'] > 0:
    print(body['data']['id'], body['data']['rev'])

Yanıt

dbs_read, tablonun eklenti sonucunu sarar ve üstüne tablonun kendi toplam sayısını ekler:

json
{
  "code": 1,
  "data": {
    "rows": [
      {
        "id": "dbs-392_tbl_a91f0e_7c2b9a11",
        "value": { "CNT_Name": "Priya Shah", "CNT_Email": "[email protected]" }
      }
    ],
    "total_rows": 1,
    "opt": { "...": "the query options this read actually ran, echoed back for reference" },
    "total_table_count": 42
  }
}

Her satır { id, value } biçimindedir: id satırın kendi belge kimliğidir (sonraki bir çağrıdaki row_id veya dbs_update/dbs_delete bunu bekler), value ise table_data gönderilirken olduğu gibi anahtarlanmış alan verisidir. total_rows bu sayfayı sayar. total_table_count tablonun tamamıdır (archived: true gönderilmediyse yalnızca etkin satırlar), yani "Sayfa 1 / N" gibi bir denetimin okuyacağı sayı.

dbs_create, satırı değil yazmayı yanıtlar:

json
{
  "code": 1,
  "data": {
    "ok": true,
    "id": "dbs-392_tbl_a91f0e_7c2b9a11",
    "rev": "1-9f8e7d6c5b4a3f2e1d0c"
  }
}

Kaydedilen value değerine ihtiyacınız varsa yeni satırı dbs_read ile (row_id değerini data.id yaparak) geri okuyun, bu çağrı onu yansıtmaz. table_data için tek bir nesne yerine bir dizi göndermek, her öğeyi tek çağrıda kendi satırı olarak ekler. Bu durumda id/rev bir kez değil, satır başına döner.

Hatalar

Sonraki