Kayıtları listele — Era Belgeleri

Bir tablonun kayıtlarını sayfalı, sıralı, aramalı ve filtreli olarak okur.

GEThttps://app.getera.io/api/v1/tables/{tableId}/records

API anahtarı

Bir tablonun kayıtlarını döndürür. Anahtar sahibinin göremediği kayıtlar (satır kuralları) listede yer almaz.

Kimlik doğrulama

x-api-key başlığında API anahtarı. Anahtar sahibinin Tablolar modülünde okuma yetkisi olmalıdır; yoksa 404 döner. Bkz. Kimlik doğrulama.

Yol parametresi

Ad	Tür	Zorunlu	Açıklama
`tableId`	UUID	Evet	Tablonun kimliği. Tabloyu açtığınızda adres çubuğunda görünür: `/tables/<tableId>`.

Sorgu parametreleri

Ad	Tür	Zorunlu	Açıklama
`limit`	sayı	Hayır	Sayfa başına kayıt. Varsayılan 25, en az 1, en çok 500.
`offset`	sayı	Hayır	Atlanacak kayıt sayısı. Varsayılan 0.
`sort`	metin	Hayır	Virgülle ayrılmış alan anahtarları. Başına `-` koyulan alan azalan sıralanır, ör. `-amount,name`.
`q`	metin	Hayır	Serbest metin araması.
`filter`	JSON	Hayır	Koşul. Tek koşul: `{"field":"status","cmp":"eq","value":"Paid"}`. Birleşik: `{"op":"and","children":[...]}`. `cmp` için örnekler: `eq`, `in`, `notempty`.

Alanlar anahtarlarıyla anılır: alanı düzenlerken görünen Anahtar değeri.

Örnek

curl -G https://app.getera.io/api/v1/tables/3f2a9c1e-0000-4000-8000-000000000001/records \
  -H "x-api-key: ERA_API_KEY" \
  --data-urlencode "limit=2" \
  --data-urlencode "sort=-amount" \
  --data-urlencode 'filter={"field":"status","cmp":"eq","value":"Paid"}'

Yanıt

{
  "list": [
    {
      "id": "8b1d0c4e-0000-4000-8000-000000000010",
      "name": "Demo Kafe",
      "status": "Paid",
      "amount": 1200,
      "created_at": "2026-10-01T09:12:00.000Z",
      "updated_at": "2026-10-03T14:40:00.000Z",
      "created_by": "c0ffee00-0000-4000-8000-000000000002"
    }
  ],
  "pageInfo": { "totalRows": 37, "limit": 2, "offset": 0, "isLastPage": false }
}

Her kayıtta önce id, sonra alanlar anahtarlarıyla, en sonda created_at, updated_at ve created_by gelir. Hesaplanan alanlar da doldurulmuş gelir.

Hatalar

Durum	Ne zaman
`400`	`filter` geçerli JSON değil ya da bilinmeyen bir alanı anıyor. Gövde `{"error": "...", "code": "..."}`.
`401`	Anahtar yok ya da geçersiz.
`403`	Anahtar sahibi çalışma alanında değil.
`404`	Tablo yok, kayıt tutan bir tablo değil ya da Tablolar'da okuma yetkiniz yok.
`429`	Hız sınırı. Bkz. Kimlik doğrulama.

Eski adres /api/v1/base/{tableId}/records aynı şekilde çalışmaya devam eder.