AutoTable'da tanımladığınız her tablo otomatik olarak kullanıma hazır bir REST API alır. Hiçbir sunucu kodu yazmazsınız: tablonun alanları neyin geçerli olduğunu belirler ve ayarları her rotayı kimin çağırabileceğine karar verir. Bu kılavuz, bu rotalar aracılığıyla oluşturmayı, okumayı, güncellemeyi, silmeyi, aramayı ve kaydedilmiş mantığı çalıştırmayı gösterir.
Tüm dinamik rotalar tek bir temel yol altında bulunur ve her tablo için aynı şekilde çalışır. Tablonuzu schemaName ile seçer, HTTP metodu ve yol ile eylemi belirlersiniz ve JSON gönderirsiniz. İşte bir orders tablosu için tam kayıt yaşam döngüsü.
# 1. Create
POST /api/v1/{tenantSlug}/{projectSlug}/dynamic/?schemaName=orders
{ "orderNumber": "A-1042", "status": "draft", "total": 184.5 }
# 2. List (paginated)
GET /api/v1/{tenantSlug}/{projectSlug}/dynamic/page?schemaName=orders&page=1&limit=20
# 3. Read one
GET /api/v1/{tenantSlug}/{projectSlug}/dynamic/66f10c1a12ab34cd56ef7890?schemaName=orders
# 4. Update only the fields that change
PATCH /api/v1/{tenantSlug}/{projectSlug}/dynamic/66f10c1a12ab34cd56ef7890?schemaName=orders
{ "status": "paid" }
# 5. Delete
DELETE /api/v1/{tenantSlug}/{projectSlug}/dynamic/66f10c1a12ab34cd56ef7890?schemaName=ordersHer URL aynı beş parçaya sahiptir. Birini okuyabilirseniz hepsini okuyabilirsiniz.
https://<host>/api/v1/acme/storefront/dynamic/page?schemaName=orders&page=1&limit=20
└──┬───┘ └───────────┬───────────┘ └──┬──┘ └─┬─┘ └─────────────────┬─────────────────┘
server tenant + project dynamic route query parameters
(which app) group (what) (which table + options)Ne yapmak istediğinizle başlayın. Bu kılavuzdaki makaleler aynı grupları takip eder.
POST / bir kayıt oluşturur, POST /multiple çoklu kayıt oluşturur. PATCH /:id ve PATCH /multiple günceller; DELETE /:id ve DELETE /multiple siler.
GET /page sayfalanmış, filtrelenebilir, sıralanabilir listeler için. GET /search metin araması için, GET /filter türlendirilmiş filtreler için, GET /table-source sayfa tabloları için.
GET /:id bir kayıt yükler. GET /selection seçiciler için etiket/değer seçenekleri döner.
GET /pipeline, kaydedilmiş bir raporu çalıştırır; POST /workflow/:workflowName, manuel bir workflow'u çalıştırır; GET /execute, dinamik bir fonksiyonu çalıştırır; GET /api, kaydedilmiş harici bir API'yi çağırır.
/:schema/:id/array/:field rotaları, gömülü bir dizi alanının satırlarını ekler, günceller, sıralar ve siler.
POST /export seçtiğiniz kayıtların XLSX dosyasını döndürür.
Sunucu, her dinamik rota için aynı sırayla aynı kontrolleri yapar. Bir çağrı başarısız olursa, hata genellikle hangi çek noktasının durdurduğunu bildirir.
Yolda kiracı ve proje kısa yolları önce çözülür. Her okuma ve yazma o projeye izole edilir.
schemaName tablo alanlarını ve ayarlarını yükler. Olmazsa 400 Schema name is required alırsınız.
Yolun ayarları (veya kaydedilmiş pipeline, workflow, fonksiyon ya da API), çağrının oturum açmış olması, bir rol gerektirmesi veya devre dışı bırakılmış olması gerekip gerekmediğini belirler.
Hız sınırları ve gövde boyutu sınırları sunucuyu korur. Aşılması herhangi bir veri işlenmeden önce hata döner.
Gövde tablo alan kurallarına karşı kontrol edilir ve yapılandırılmış iş akışları işlemle birlikte çalışır.
Yazmalar { status, message, data } döndürür. Okumalar kayıtları doğrudan veya sayfalı öğe zarfı içinde döndürür.
Bu sırayla okuyun ve ihtiyacınızı karşılayacak şekilde durun.
Doğru URL oluşturun ve schemaName'in tabloyu nasıl seçtiğini anlayın.
Rotaları herkese açık veya özel yapın, doğru başlıkları gönderin ve yanıtları ve hataları anlayın.
Kayıt oluşturma, listeleme, okuma, güncelleme ve silme - en çok kullanacağınız rotalar.
Search, filter, table sources, pipelines, workflows, functions, and external APIs.
Gömülü dizi satırları, XLSX dışa aktarma, sınırlar ve tam rota listesi.