API başvurusu — Era Belgeleri

Era API'sinin tamamı modül tanımlarından üretilir: bir modüle eklenen her işlem aynı anda bir uç nokta, bir SDK yöntemi, bir era komutu, bir MCP aracı ve bu başvurudaki bir bölüm olur. Bu sayfalar da aynı kaynaktan üretildiği için API'den ayrı düşemez.

Şu an 56 modül, 985 işlem, 300 veri modeli ve 769 olay var. Makinece okunabilir sözleşme: /api/v1/openapi.json (OpenAPI 3.1, sürüm 2026-10-22).

Hızlı başlangıçAnahtar oluştur, ilk isteği gönder.Kimlik doğrulamaAPI anahtarları, OAuth ve yetki kapsamları.SDK@getera/sdk ile her model ve işlem, türleriyle.

Bir işlem bölümü nasıl okunur

Adresler — kayda bağlı işlemler /api/v1/<kaynak>/{id}/actions/<işlem>, koleksiyon işlemleri /api/v1/<kaynak>/actions/<işlem> adresindedir; her işlemin ayrıca asıl adresi POST /api/v1/actions/<modül.işlem> vardır.
Gereken izin — <modül>:<yetenek>. Anahtarın ya da token'ın bu izni taşıması ve arkasındaki kişinin rolünün buna izin vermesi gerekir.
Ön koşullar — işlem çalışmadan önce denetlenir; tutmazsa 409 ve koşulun kodu döner.
Yanıt — { "ok": true, "result": …, "events": [...] }. result işlemin döndürdüğü değerdir (çoğunlukla yazdığı kaydın kimliği).
Yazma istekleri Idempotency-Key başlığı alır; aynı anahtarla tekrar gelen istek 24 saat boyunca ilk sonucu döndürür (Idempotency-Replayed: true).

Modüller

Modül	Kod	Ne işe yarar	İşlem	Model	Olay
Abonelikler	`subscriptions`	Sabit fiyatlı, her dönem yenilenip faturalanan tekrarlayan planlar.	9	2	9
Açılır pencereler	`popups`	Web sitesi açılır pencereleri, hedefleme ve A/B dönüşüm ölçümleri.	4	2	2
Aktivite	`activity`	Çalışma alanınızda olan her şeyin canlı akışı.	2	2	2
Altyapı	`platform`	Başka araçları bağlamak için API anahtarları, webhook’lar ve arka plan işleri.	19	1	16
Ayarlar	`settings`	İşletmeniz, bu çalışma alanı ve her modül için ayarlar.	1	2	1
Belge talepleri	`lead_documents`	Bir potansiyel müşteriden bağlantıyla belge isteyin — giriş yapması gerekmez.	7	3	6
Bildirimler	`notifications`	Kimin neden haberdar edileceği — e-posta, SMS, WhatsApp veya uygulama içi.	20	7	18
Bütçeler	`budgets`	Her gider kategorisi için harcama planı; aşıldığında uyarır.	6	2	5
Diller	`i18n`	Çalıştığınız ve yayın yaptığınız diller ile çevirileriniz.	4	2	4
Dosyalar	`files`	Yüklediğiniz, oluşturduğunuz veya size gelen her dosya; klasörlerde, önizlemeli.	14	3	16
Ekip	`employees`	Ekip rehberi ve personel dosyaları — işe alım, oryantasyon ve ayrılış.	4	1	4
Entegrasyonlar	`integrations`	Pazaryerleri, e-ticaret siteleri, kargo ve e-fatura — siparişleriniz, ürünleriniz, stoğunuz ve müşterilerinizle eşitlenir.	22	8	22
Era içgörüleri	`insights`	Era sen sormadan söyler: işinde neyin değiştiğini kaynaklarıyla, doğrulayamadıklarıyla ve bir sonraki adımla — yalnız sana.	6	2	0
Era Masaüstü	`station`	Era Masaüstü’nüzün sohbetleri, bekleyen onaylar, planlar, yapılacaklar ve otomatik işler — Era’da, yalnızca sizin.	6	0	6
Etiketler	`tags`	Tüm kayıtlar için tek ortak etiket listesi, kendi renklerinizle.	6	2	6
Etkinlikler	`happenings`	Biletli, kayıtlı ve giriş listeli tek seferlik etkinlikler.	11	3	9
Faturalar	`invoices`	Her satırında vergisi olan numaralı faturalar ve iade faturaları.	14	4	12
Finans	`finance`	Müşterilerin borçları ve ödemeleri, işletmenin harcamaları.	42	13	30
Formlar	`forms`	Herkesin doldurabileceği formlar; yanıtlar potansiyel müşteri veya Base kaydı olarak gelir.	7	3	8
Gelen kutusu	`inbox`	Tüm kanallar tek gelen kutusunda — konuşmalar, yanıtlar, ekipler ve kimin yanıtladığı.	63	22	45
Geliştir	`build`	Fikrinizi gerçek bir uygulamaya dönüştürün: Era onu kendi yapı taşlarından kurar ya da kodlama araçlarınız deponuzu değiştirir ve Era önizlemeli bir pull request açar.	10	2	6
Gizlilik	`privacy`	Kişisel veri talepleri — müşterinin verisini dışa aktarın veya silin, kaydı tutulsun.	7	1	6
Görünümler	`view_grid`	Kayıtlı listeler — seçtiğiniz sütunlar, filtreler ve sıralama.	5	2	3
Grup dersleri	`group_classes`	Kontenjan, eğitmen, rezervasyon ve yoklamayla haftalık ders programı.	12	4	11
Güvenlik ve erişim	`security_access`	Roller ve her rolün neyi görüp yapabileceği.	14	6	15
Hediye kartları	`gift_cards`	Kodu, bakiyesi, son kullanma tarihi ve tüm geçmişiyle hediye kartları.	11	3	7
İndirimler	`discounts`	Kampanyalar ve indirim kodları — indirimli satışlar, sipariş fırsatları ve hediyeler.	12	10	13
İşler	`work`	Bir kez iste: Era planlar, işi paralel çalışan uzmanlara böler ve kullanıp yayımlayabileceğin bitmiş işi getirir.	23	5	18
Kampanyalar	`campaigns`	Müşterilerinize e-posta, SMS ve WhatsApp kampanyaları; açılma ve tıklamalarla.	16	7	12
Katalog	`catalog`	Sattığınız veya randevuya açtığınız her şey — ürünler, hizmetler, fiyatlar, kategoriler ve markalar.	25	9	19
Kreatif Stüdyo	`creative`	Anlat, gör, kullan — yapay zekâyla ürün fotoğrafları, gönderiler, hikâye videoları, seslendirme ve müzik.	26	5	8
Mağaza	`retail`	Satış kanalları, stok, kargo ve siparişler — sepetten kapıya.	74	33	56
Müsaitlik	`availability`	Çalışma saatleri, özel günler, izinler ve hangi hizmeti kimin verdiği.	13	7	12
Müşteriler	`customers`	Her müşteri için tek kayıt; tüm modüller aynı kaydı kullanır.	27	6	18
Organizasyon	`organizations`	İşletmeniz, çalışma alanları, markanız ve ekibiniz.	17	1	19
Otomasyonlar	`workflows`	Olan bitene tepki veren ya da zamanlanmış çalışan, işi sizin yerinize yapan otomasyonlar.	10	3	10
Paketler	`packages`	Hizmet ve dersleri bir araya getiren, seansları sayılan aylık paketler.	7	3	6
Panolar	`dashboards`	Base tablolarınızdan sayılar, grafikler ve tablolarla panolar.	6	2	3
Paylaşılan görünümler ve formlar	`data_sharing`	Bir Base görünümünü gizli bir bağlantıyla paylaşın ya da form olarak yayımlayın.	3	1	3
Randevular	`appointments`	Çalışma saatlerinize, aralara, izinlere ve kapasiteye uyan online randevu.	26	6	20
Raporlar	`reports`	Satış ve finans raporları ile her birini kimlerin görebileceği.	5	2	4
Resources	`resources`	Rooms, pitches, cars, chairs and equipment people book — by the hour or by the day.	7	3	7
Satış	`crm`	Potansiyel müşteriler, onları takip eden aramalar ve size potansiyel müşteri gönderen iş ortakları.	31	11	27
Ses	`voice`	Era’larınız telefonu ve web sitenizi sesle yanıtlar, randevu verir, mesaj alır ve her aramayı Gelen kutusuna kaydeder.	22	3	13
Tablo eşitleme	`data_sync`	Bir tabloyu dış bir veritabanından, Airtable’dan veya bir CSV bağlantısından düzenli olarak doldurun.	7	2	8
Tablolar	`data`	Size ait tablolar ve her kayda ek alanlar.	37	0	27
Teklifler	`quotes`	PDF’i ve müşterinin kabul ya da reddedebileceği bir bağlantısı olan fiyat teklifleri.	13	5	12
Toplantılar	`meetings`	Era toplantılarınıza katılır — not alan bir botla ya da bilgisayarınızdan botsuz —, öncesinde ön bilgi verir, sonrasında notları, görevleri, takip e-postasını ve sonraki adımları yazar.	33	4	16
Uygulamalar	`apps`	Bağladığınız uygulama ve servisler ile onlara gönderilen güncellemeler.	14	1	12
Ürün türleri	`attributes`	Ürün türleri ve renk, beden, malzeme gibi yeniden kullanılabilir özellikler.	14	8	10
Vergi	`tax`	Ülkeye ve ürün tipine göre vergi oranları; her satışa uygulanır.	7	4	4
Web sitesi	`site`	Ziyaretçilerin sitenizde okuduğu sayfalar, yazılar, sık sorulan sorular ve yasal metinler.	76	22	44
Yapay zekâ	`ai`	Asistanınız Era ve kaydettiğiniz yapay zekâ ajanları — tüm modüllerle çalışırlar.	86	29	76
Yardım merkezi	`help_center`	Müşterileriniz ve destek ekibiniz için kategorilere ayrılmış yardım makaleleri.	8	2	7
Yerinde hizmet	`field_service`	Müşterinin adresinde hizmet — kim gidiyor, ne zaman varıyor, imza ve fotoğraf.	5	1	7
Yorumlar	`comments`	Herhangi bir kayıtta ekibiniz için notlar ve yanıtlar.	9	3	9