Geliştiriciler için
Zinn Digital® API odaklı bir platformdur. Kontrol panelimizi çalıştıran motor API'sinin aynısı size sunulur; sürüm oluşturulmuş, şartname öncelikli ve derleme anında %100 belgelendirilmiştir; ayrıca üzerinde oluşturulmuş SDK'lar, bir CLI, bir Terraform sağlayıcısı, imzalı webhook'lar ve bir MCP sunucusu barındırır. Çalışmak için ne kullanırsanız kullanın —bir terminal, bir işlem hattı, bir durum dosyası veya bir AI ajanı— platform buna yanıt verir.
Çoğu sağlayıcı, kontrol paneline sonradan bir API ekler ve bu hemen belli olur; panelin özelliklerinin yarısı hiçbir zaman dışarı çıkmaz. Biz ise tam tersini yaptık. Kontrol paneli, yönetici konsolu, CLI, Terraform sağlayıcısı, MCP sunucusu ve kendi entegrasyonlarınızın tümü aynı motor API'sini kullanır. Panelde yapabildiğiniz her şeyi kodla da yapabilirsiniz.
OpenAPI belirtimi tek gerçek kaynaktır ve bu belirtimde yer almadığı sürece hiçbir uç nokta yayınlanmaz. Genel API'nin sonunda değil, derleme anında tam olarak belgelenmiş olmasını sağlayan tek kural budur; belgelenmemiş hiçbir köşe yoktur, çünkü belgelenmemiş bir uç nokta var olamaz.
Etkileşimli referans belgeleri, dört istemci SDK'sı, CLI'ın büyük kısmı ve Terraform sağlayıcı iskelesi, bu tek teknik özellikten üretilir. Tek kaynak, birçok yapı, her zaman senkronize — uygulamadan uzaklaşmış bir belgeyi asla kovalamazsınız.
Uç noktalar, yayınlanmış bir kullanım dışı bırakma politikası ve bir değişiklik günlüğü ile /v1 altında bulunur. Bir şeyler değişmeden önce, bunu bozuk bir derlemeden fark etmek yerine, yazılı olarak bildirilirsiniz.
Her değişiklikte uygulama-özellik sözleşme testleri ve OpenAPI denetimi çalışır. Kod ile sözleşme arasındaki uyumsuzluk derlemeyi başarısız kılar; dolayısıyla istemcinizi oluşturduğunuz özellik, sunucunun gerçekten uyguladığı özelliktir.
İçeri giden iki yol, arkalarında ise tek bir ortak kural var. Hangisini kullanırsanız kullanın, aynı yetki kontrolleri ve aynı veritabanı düzeyinde izolasyon geçerlidir.
Anahtarlar zdk_<mode>_<prefix>_<secret> biçimindedir. Gizli anahtarın yalnızca SHA-256 özeti saklanır; anahtar verildikten sonra onu size tekrar gösteremeyiz ve veritabanımıza erişen hiç kimse de gösteremez. Anahtarlar yetki kapsamları (scope) taşır, iptal edilebilir ve kişiye değil, kuruluşa özel olarak verilir.
Korumalı alan anahtarları, üretim anahtarlarından ayrıdır ve korumalı alan modunda çalışır: gerçek faturalandırma ve gerçek sağlama yapılmaz. Entegrasyon testleriniz para harcamadan veya sunucu kurmadan API'ye istek gönderebilir.
Kullanıcı oturumları, Keycloak tarafından verilen ve alan adı (realm) genel anahtarına karşı doğrulanan JWT'ler ile kimlik doğrulaması yapar ve bir API anahtarının yaptığı ile aynı Principal nesnesine çözümlenir. Uç noktalar, kuruluş başına kontrol edilen siteler.create veya apikeys.manage gibi ayrıntılı izin anahtarları üzerinde denetim uygular; bir kuruluştaki izin, altında iç içe geçmiş kuruluşlar için geçerli olsa da, ayrı ve ilişkisiz bir kuruluşta hiçbir erişim sağlamaz.
Her kiracı isteği, asıl kullanıcıdan (principal) ayarlanan Postgres organizasyon kapsamıyla bir işlem içinde çalıştırılır; böylece izolasyon, birinin unutabileceği bir ORM filtresiyle değil, veritabanı tarafından zorlanır. Sorgu kümesi (queryset) filtresi, derinlemesine savunma amacıyla hâlâ mevcuttur.
Bir API'nin bir README dosyasında güzel görünmesini sağlamak kolaydır, ancak gerçek trafik altında düzgün çalışmasını sağlamak zordur. Integrasyonları gece saat üçte bozan kısımlar bunlar olduğu için, üzerinde en çok ter döktüğümüz kısımlar da bunlardır.
Toplu çalışmanın davranışını şekillendirmesi nedeniyle özellikle belirtmeye değer bir detay var: yinelenen alan adlarında alınan 409 yanıtı, herhangi bir kiracı için "bu sunucu adı burada mı barındırılıyor?" sorusunu yanıtlar; bu da bir numaralandırma kehanetidir ve Footprint-Free'e karşı gerçek bir kimlikten arındırma riskidir. Site oluşturmayı sınırlamak tembelce bir çözüm olurdu ve toplu sağlama ürününü tamamen bozar. Bunun yerine yalnızca reddedilen yinelenen alan adı denemeleri, ilke başına bütçelendirilir. Başarılı oluşturma işlemlerinden asla ücret alınmaz; böylece tüm gün toplu olarak sağlama yapabilir ve yoklama neredeyse anında sonlandırılır.
Aynı teknik özelliklere sahip üç tüketici, üç farklı çalışma yöntemi için.
TypeScript, Python, PHP ve Go için oluşturulan bu sürüm, el yazımı bir sarmalayıcıyı (wrapper) beklemek zorunda kalmadan dilinize yeni bir uç noktanın (endpoint) gelmesini sağlamak amacıyla spesifikasyonu takip eder.
Bir WordPress sitesi kurun, Node dışında hiçbir şey kurulu olmadan yerel olarak çalıştırın ve dağıtın. Zinnector®, projenizi dağıtacağınız yuvaya (PHP sürümü, disk, dosya sayısı) karşı ön kontrolden geçirir ve gönderim sonrasında değil, önce uyarır. Ayrıca oturum açar, siteleri listeler, dağıtım yapar, etki alanlarını ve DNS'i yönetir, posta servislerini okur, yedekleme alır, izin verilen WP-CLI'yi çalıştırır, günlükleri izler ve toplu işlemler başlatır. Ücretsizdir, MIT lisanslıdır ve aynı bu genel API üzerine inşa edilmiştir.
Siteleri, alan adlarını, DNS kayıtlarını, posta kutularını ve planları altyapı kod yönetimi olarak yönetin. terraform apply barındırma hizmetini sağlar; böylece ortamlarınız, kimsenin bir yere not etmediği tıklamalar dizisi yerine tekrarlanabilir ve incelenebilir hale gelir.
Sunucunun uyguladığı uç noktaları tam olarak açıklayan ve tarayıcıdan okuyup çağırabileceğiniz oluşturulmuş belgeler; çünkü her ikisi de aynı şartnameden gelir.
Platformun arkasında dayanıklı bir olay omurgası yer alır: her durum değişikliği, veritabanı değişikliğiyle atomik olarak Postgres içindeki işlemsel bir outbox'a bir olay yazar ve bir aktarıcı bunu NATS JetStream üzerine yayınlar. Olaylar tiplendirilmiş ve versiyonlanmıştır — site.deployed, order.paid, invoice.overdue, backup.completed, abuse.flagged, trial.ending ve diğerleri.
Bir uç noktayı WebhookSubscription olarak kaydedin ve alacağı olay türlerini seçin. Tek bir akış bildirimleri, analitiği, otomasyonları ve entegrasyonunuzu aynı anda besler; bizim kullandığımız olayların aynısını tüketiyorsunuz.
Her teslimat HMAC ile imzalanmıştır; böylece üzerinde işlem yapmadan önce bizden geldiğini doğrulayabilirsiniz.
Başarısız teslimatlar kademeli artışla yeniden denenir ve her deneme bir WebhookDelivery olarak kaydedilir. Ne gönderdiğimizi sormak için desteğe e-posta göndermek yerine, kontrol panelinden teslimatları inceleyebilir ve yeniden oynatabilirsiniz.
İşlem hattı, tam olarak bir kez (exactly-once) çalıştığını iddia etmek yerine bilinçli olarak en az bir kez (at-least-once) çalışacak şekilde tasarlanmıştır. Yayın sırasında çöken bir aktarıcının talep kirası sona erer ve olayları yeniden yayınlanır. Zarf kimliği (envelope id) üzerinden mükerrer kayıtları ayıklayın (dedupe) ve tüketiciniz yapı gereği doğru olacaktır.
Bir API, bir geliştirici hikayesinin yalnızca yarısıdır. Diğer yarısı ise yayına almaktır.
Platformu barındırılan bir MCP sunucusu olarak sunuyoruz: altyapı API'si üzerinde çalışan, aynı eylem kataloğunu, RBAC'ı ve denetim izini yeniden kullanan ince bir protokol adaptörü. Claude Code, Cursor, ChatGPT, Claude Desktop veya MCP uyumlu herhangi bir istemciyi bir kez bağlayın; API'ye eklediğimiz her yetenek otomatik olarak kullanılabilir hale gelir.
Ajan üç şey alır: Araçlar (aynı API uç noktaları, sapma gösterecek paralel mantık yok), Kaynaklar (işlem yapmadan önce gerçek verilerle teşhis koyabilmesi için salt okunur site sağlığı, yapılandırma, son loglar, metrikler, çalışma süresi ve KB makaleleri) ve İstemler ("bu siteyi teşhis et" veya "bir göç hazırla" gibi yayınlanmış iş akışı şablonları).
Güvenlik de kimlik doğrulama ile aynı hikayedir: OAuth 2.1, kuruluşunuza bağlı belirteçler ve satır düzeyinde güvenlik zorlanmış, araca göre kapsamı belirlenmiş ve iptal edilebilir RBAC izinleri, üretimden ayrılmış korumalı alan. Yıkıcı eylemler (silme, askıya alma, faturalandırma, büyük harcama) açık onay veya insan onay politikası gerektirir. Oran sınırlamaları ve harcama üst sınırları, yapay zeka tarafından tetiklenen ücretli eylemleri sınırlandırır; ayrıca her MCP çağrısı kimlik, araç, argümanlar ve sonuç ile birlikte denetim günlüğüne kaydedilir.
Her uygulamayı ayrı ayrı entegre etmek yerine protokolü destekliyoruz; bu da barındırma entegrasyonunuzun değişmesine gerek kalmadan yapay zeka araçları tercihinizi değiştirebileceğiniz anlamına gelir.
Evet — bu aynı motor API'sidir, yayınlanmış ve sağlamlaştırılmıştır. Kontrol paneli, yönetici konsolu, CLI, Terraform sağlayıcısı, MCP sunucusu ve web kancalarının tümü tek bir yüzeyin tüketicileridir; API'nin panelin gerisinde kalmamasının nedeni de budur.
Evet. Sandbox anahtarları, üretim anahtarlarından ayrı olarak verilir ve test modunda çalışır: gerçek faturalandırma ve gerçek kaynak sağlama yoktur. CI sisteminizi sandbox kimlik bilgilerine yönlendirin ve tam istek ile yanıt döngüsünü güvenle test edin.
POST isteğinizde bir Idempotency-Key gönderin. Yeniden oynatma kaydı (replay record) satır içi yerine işlem onaylandığında (commit) yazılır, böylece bir yeniden deneme (retry) asla gerçekten onaylanmamış bir satır için önbelleğe alınmış bir başarıyı yeniden oynatamaz ve başarısız olan bir istek kilit serbest bırakma işlemini hemen gerçekleştirir, böylece düzeltilmiş yeniden denemeniz bekletilmez. Webhook teslimi tasarım gereği en az bir kez (at-least-once) gerçekleştirilir — kendi tarafınızda zarf kimliğine (envelope id) göre mükerrer kayıt temizliği (dedupe) yapın.
Bugün değil. API anahtarları organizasyon başına verilir; bu nedenle birden fazla müşteri organizasyonunu kapsayan bir entegrasyon, her biri için ayrı bir anahtar tutar. Yetkiler de kullanıcı asılları için organizasyon bazında kontrol edilir: bir organizasyonda sites.create yetkisine sahip olmak, ayrı ve ilişkisiz başka bir organizasyonda erişim sağlamaz, ancak bunun altında iç içe geçmiş organizasyonlar için geçerlidir. Bu bilinçli bir tercihtir; ele geçirilmiş bir anahtarın tüm platformu değil, yalnızca kendi organizasyonunu ve altındaki alt organizasyonları etkilemesini sağlar.
Yazılımcı rolü; kuruluş okuma, API anahtarı yönetimi, site görüntüleme ve oluşturma, siteleri yeniden başlatma, önbelleklerini temizleme ve destek taleplerini görüntüleme ile yanıtlama işlemlerini kapsar. Fatura kontrolünü bilinçli olarak dışarıda bırakır. Dağıtım (deploy) ve canlıya alma (push-to-live) izinlerinin bu rolün bir parçası olmadığını unutmayın; bir ekip üyesinin bunlara ihtiyacı olması durumunda, Geliştirici rolünün en kapsamlı teknik rol olduğunu varsaymak yerine, bu izinleri barındıran bir rol atayın.
Teslimatlar kademeli gecikmeyle yeniden denenir ve her girişim inceleyebileceğiniz bir WebhookDelivery olarak kaydedilir. Kaynak tarafta, olaylar değişikliğin kendisiyle aynı veritabanı işleminde işlemsel bir giden kutusuna yazılır; böylece bir tüketici kullanılamaz durumdayken hiçbir şey kaybolmaz — çalışmayan bir tüketici gecikir ancak asla üreticiyi bozmaz ve geri döndüğünüzde teslimatları panelden yeniden oynatabilirsiniz.
Kredi kartı gerektirmeyen 14 günlük Footprint-Free Hosting denemenizi başlatın; ödeme bilgisi gerekmez, en fazla 5 site barındırabilirsiniz. Ücretli Footprint-Free paketleri PBN 5 için ayda 6$'dan başlar. Her planda 30 günlük para iade garantisi, ücretsiz taşıma ve satıcıya bağımlı kalmama imkanı sunulur.
Önce özellik odaklı API, üretilmiş SDK'lar, bir CLI, bir Terraform sağlayıcısı, imzalı web kancaları ve bir MCP sunucusu — dünya çapında 650.000'den fazla site için inşa ettiğimiz barındırma üzerinde. Kart gerektirmeyen 14 günlük deneme sürümüyle başlayın, ödeme bilgisi gerekmez.
Ücretsiz başla