gRPC servisleriyle çalışıyorsanız, muhtemelen jenerik API araçlarının sınırlarına ulaşmışsınızdır. Birçok istemci gRPC'yi sonradan eklenmiş bir özellik olarak görür. Kreya ise tam tersi bir yaklaşım sergiler. gRPC'yi merkeze alır ve diğer protokolleri onun etrafında inşa eder.
Bu rehber, Kreya'nın ne olduğunu, neleri iyi yaptığını, çalışmalarınızı nasıl sakladığını ve kimlere uygun olduğunu açıklamaktadır. Sonunda, iş akışınıza uyup uymadığını anlayacaksınız.
Başlamadan önce küçük bir not. Bu makale, riok GmbH tarafından yapılan ve kreya.app adresinde bulunan Kreya API istemcisini ele almaktadır. Adını paylaşan bir moda veya güzellik markası değildir. Eğer buraya giyim için geldiyseniz, yanlış yerdesiniz.
Kreya Nedir?
Kreya, İsviçre merkezli bir yazılım şirketi olan riok GmbH tarafından geliştirilen bir masaüstü GUI API istemcisidir. Çeşitli protokoller üzerinden API'leri çağırmak ve test etmek için size grafiksel bir arayüz sunar.
gRPC, REST, GraphQL, WebSocket ve Server-Sent Events'i destekler. Bu, modern bir arka uç geliştiricisinin bir gün içinde dokunduğu çoğu şeyi kapsar. Bir kez kurarsınız ve bu protokollerden herhangi birini tek bir pencereden çağırabilirsiniz.
Kreya, freemium modele sahip tescilli bir yazılımdır. Çekirdek istemci ücretsiz olarak kullanılabilir. Ücretli katmanlar, bireyler ve ekipler için gelişmiş özellikler ekler. Fiyatlandırma yapısını daha sonra ele alacağız.
Ürün, macOS, Windows ve Linux üzerinde yerel bir masaüstü uygulaması olarak çalışır. Tarayıcı sürümü veya zorunlu bir bulut hesabı yoktur. İndirir, kurar ve API'leri çağırmaya başlarsınız.
gRPC-Odaklı Konumlandırma
Çoğu API istemcisi hayatına REST araçları olarak başladı. gRPC'yi daha sonra, genellikle ince bir katman olarak eklediler. Kreya bu sırayı tersine çevirir. gRPC desteği derinlemesine, sonradan eklenmiş değil.
Bir servisi iki şekilde yükleyebilirsiniz. Doğrudan bir .proto dosyasını içe aktarabilir veya çalışan bir sunucudan servis tanımını çekmek için gRPC sunucu yansımasını kullanabilirsiniz. Yansıtma, proto dosyalarını her zaman elinizde bulundurmanız gerekmediği anlamına gelir. Sunucu onları ifşa ediyorsa, Kreya sizin için okur.
Tüm gRPC çağrı türlerini destekler. Buna tek yönlü istekler, istemci akışı, sunucu akışı ve çift yönlü (dupleks) akış dahildir. Birçok araç tek yönlü çağrılarda durur. Kreya, gerçek akış servisleri oluşturduğunuzda önemli olan tüm aralığı kapsar.
Altyapıda, gRPC'nin bağlı olduğu HTTP/2 protokolünü kullanır. Ayrıca HTTP/1.1 ve HTTP/3'ü de destekler. Protokolün kendisine odaklanmış bir başlangıç kılavuzu istiyorsanız, gRPC istemci rehberimize ve gRPC API'leri nasıl test edeceğinize dair anlatıma göz atın.
Çoklu Protokol Desteği
gRPC manşet başlığı olsa da, Kreya tek protokollü bir araç değildir. Normal bir geliştirme sırasında başvurduğunuz yaygın protokolleri ele alır.
REST için, istekleri metotlar, başlıklar, sorgu parametreleri ve gövdelerle oluşturur, ardından yanıtı incelersiniz. Bu, API çalışmasının temelidir. Bu konuda yeniyseniz, REST API istemcilerine genel bakışımız bu kategoriyi açıklar.
GraphQL için, bir GraphQL uç noktasına sorgular ve mutasyonlar gönderir ve yapılandırılmış yanıtı okursunuz. GraphQL ana protokolünüzse, en iyi GraphQL istemcileri derlememiz size daha geniş bir bakış açısı sunar.
Gerçek zamanlı çalışma için Kreya, WebSocket ve Server-Sent Events'i destekler. WebSocket size iki yönlü bir kanal sağlar. SSE size sunucudan istemciye tek yönlü bir akış sağlar. Her ikisi de canlı veri akışlarını veya sohbet tarzı servisleri test ederken kullanışlıdır.
Belirli bir iş için hangi protokolü seçeceğinizi merak ediyorsanız, REST vs GraphQL vs gRPC karşılaştırmamız, avantaj ve dezavantajlarını anlatır.
Çevrimdışı, Gizliliğe Öncelikli ve Git-Diff Edilebilir Depolama
Üç tasarım tercihi Kreya'yı bulut öncelikli araçlardan ayırır. Bunlar genellikle sıkı veri kuralları olan ekipler için en çok önem taşır.
Tamamen çevrimdışı çalışır
Kreya, internet bağlantısı olmadan makinenizde çalışır. İstekleriniz, ortamlarınız ve yanıtlarınız yerel kalır. İstek göndermek için bir bulut hizmetine giriş yapmanız gerekmez. Güvenlik duvarının arkasında veya hassas sistemlerde çalışan geliştiriciler için bu gerçek bir avantajdır. Bu kategori hakkında daha fazla bilgi için en iyi çevrimdışı API istemci seçenekleri rehberimize bakın.
Varsayılan olarak gizliliğe öncelikli
Her şey cihazınızda kaldığı için, API verileriniz varsayılan olarak kontrolünüzden çıkmaz. İstek gövdelerini bir satıcı sunucusuna çeken bir telemetri yoktur. Kreya kendini gizliliğe öncelikli olarak pazarlar ve varsayılan olarak çevrimdışı tasarım bunu destekler. Kurumsal çevrimdışı lisans, kilitli ortamlar için hesap gereksinimini tamamen kaldırabilir.
Git-diff edilebilir proje depolama
Mühendislik ekiplerini etkileyen özellik budur. Kreya her projeyi diskte düz, yapılandırılmış JSON dosyaları olarak saklar. Bu dosyalar git-diff edilebilir olduğundan, diğer kodlar gibi deponuza taahhüt edersiniz.
Bunun getirisi gerçek sürüm kontrolüdür. API değişikliklerini çekme isteklerinde incelersiniz. Bir ekip arkadaşınızın bir istekte tam olarak neyi değiştirdiğini görürsünüz. Kötü bir düzenlemeyi git revert ile geri alırsınız. Sizinle geçmişiniz arasında tescilli bir senkronizasyon formatı bulunmaz.
Bu, Kreya'yı diğer git-yerel API istemcileri ile aynı aileye koyar. Ekibiniz zaten Git'te yaşıyorsa, API tanımlarınız da orada yaşar.
Test ve Otomasyon
Kreya sadece bir keşif aracı değildir. Aynı zamanda API'lerinizin zaman içinde doğru çalıştığını doğrulamanıza da yardımcı olur.
Otomatik testleri destekler. Yanıtları doğrulamak için JavaScript'te betikli testler yazarsınız. Belirli bir girdi kümesi üzerinde yineleme yapan veri odaklı testler çalıştırabilirsiniz. Bu, anlık kontrolleri tekrarlanabilir süitlere dönüştürür.
Ayrıca anlık görüntü testleri de sunar. Bir anlık görüntü, bir temel yanıtı yakalar. Bir sonraki çalıştırmada Kreya, canlı yanıtı bu temelle karşılaştırır ve herhangi bir sapmayı işaretler. Bu, API sözleşmenize kasıtsız değişikliklerin üretime ulaşmadan önce yakalanmasını sağlar.
Sürekli entegrasyon için Kreya, JUnit tarzı raporlama ile CLI otomasyonu sağlar. Kaydedilmiş testlerinizi bir işlem hattında çalıştırır ve sonuçları CI panonuza beslersiniz. Bu, yerel test ile derleme sisteminiz arasındaki döngüyü kapatır.
Freemium Modeli
Kreya, üç katmanlı bir freemium fiyatlandırma modeli kullanır. Kesin dolar miktarları değişebilir, bu nedenle taahhütte bulunmadan önce resmi Kreya fiyatlandırma sayfasını kontrol edin.
Ücretsiz plan sonsuza dek ücretsizdir. Çekirdek protokolleri, gRPC, REST, GraphQL, WebSocket ve temel kimlik doğrulama yöntemlerini kapsar. Yalnız keşif ve günlük istek çalışmaları için ücretsiz katman oldukça yeterlidir.
Pro planı bireyleri hedefler. Gelişmiş özellikler ekler: betik oluşturma, anlık görüntü testi, koleksiyonlar, istek geçmişi ve e-posta desteği. Otomatik testlere güveniyorsanız, bu büyüdüğünüz katmandır.
Enterprise planı şirketleri hedefler. Öncelikli destek, müşteri portalı, sınırsız kullanıcı için sabit oranlı fiyatlandırma ve hesap kullanamayan ortamlar için çevrimdışı lisans seçeneği ekler.
Ücretli planlar genellikle satın almadan önce gelişmiş özellikleri test edebilmeniz için kısa bir deneme süresi sunar.
Kreya Kimlere Uygun?
Kreya, belirli bir profile uyar. Bir veya daha fazlasını karşılıyorsanız güçlü bir seçimdir:
- gRPC-odaklı geliştiriciler. Arka ucunuz gRPC üzerinde çalışıyorsa, Kreya'nın yansıtma desteği ve tam akış kapsamı onu doğal bir ev haline getirir.
- Gizliliğe duyarlı ekipler. Verileriniz makinelerinizden ayrılamıyorsa, çevrimdışı, yerel öncelikli tasarım gerçek bir sorunu çözer.
- Git-merkezli ekipler. API tanımlarının çekme isteklerinde incelenmesini istiyorsanız, git-diff edilebilir depolama, iş akışınıza sorunsuz bir şekilde uyar.
- Çok protokollü şirketler. Bir gün içinde gRPC, REST ve bir WebSocket beslemesine dokunuluyorsa, üçünü de halleden tek bir araç bağlam değiştirmeyi engeller.
Barındırılan, tarayıcı tabanlı bir çalışma alanına ihtiyacınız varsa veya tüm ekibiniz Mac, Windows ve web genelinde çalışıyorsa ve paylaşılan bir bulut belgesi istiyorsa daha az açık bir uyum sağlar. Kreya, tasarımsal olarak masaüstü önceliklidir.
Apidog Nerede Uyar?
Kreya, gerçek gRPC derinliğine sahip, odaklanmış, gizliliğe öncelikli bir API istemcisidir. İhtiyaçlarınız yerel bir masaüstü aracıdan API'leri çağırma ve test etme noktasında duruyorsa, bu işi iyi yapar.
Ancak bazı ekipler bir istemciden fazlasını ister. API'yi tasarlamak, arka uç mevcut olmadan önce onu taklit etmek, tüketiciler için belgelemek ve gerçek zamanlı olarak işbirliği yapmak isterler. Bu farklı bir kapsamdır.
Apidog, bu daha geniş kapsam için tasarlanmış hepsi bir arada bir API platformudur. Kreya gibi gRPC, REST, GraphQL ve WebSocket'i (artı SOAP ve Socket.IO) ele alır. İstemcinin yanı sıra, görsel bir OpenAPI tasarımcısı, Apidog CLI aracılığıyla CI/CD ile otomatik test senaryoları, akıllı taklit, otomatik oluşturulmuş etkileşimli belgeler ve paylaşılan ekip çalışma alanları ekler. Windows, Mac ve Linux için bir masaüstü uygulaması, ayrıca bir web uygulaması ve bir CLI olarak sunulur.
Dürüst takas: Kreya varsayılan olarak daha yalın ve çevrimdışı önceliklidir, ki bazı ekipler bunu tercih eder. Apidog, istemcinin yanı sıra tasarım, taklit, belgeler ve işbirliği gerektiğinde tam API yaşam döngüsünü tek bir yerde kapsar. Seçenekleri değerlendiriyorsanız, Postman alternatifleri derlememiz ve daha geniş muhteşem API istemcileri listesi her ikisini de bağlama oturtur.
Sıkça Sorulan Sorular
Kreya ücretsiz mi?
Evet. Kreya'nın gRPC, REST, GraphQL, WebSocket ve temel kimlik doğrulamayı kapsayan sonsuza dek ücretsiz bir planı vardır. Ücretli Pro ve Enterprise katmanları betik oluşturma, anlık görüntü testi ve ekip desteği ekler.
Kreya açık kaynak mı?
Hayır. Kreya, riok GmbH tarafından yapılan tescilli bir yazılımdır. Ücretsiz katmanı erişilebilir olmasını sağlar, ancak kaynak kodu açık değildir. Açık kaynak sizin için önemliyse, aynı zamanda açık olan ücretsiz API istemci seçeneklerine bakın.
Kreya çevrimdışı çalışır mı?
Evet. Kreya, tamamen çevrimdışı çalışan bir masaüstü uygulamasıdır. Projeleriniz, ortamlarınız ve yanıtlarınız makinenizde kalır. İstek göndermek için bulut hesabı gerekmez.
Kreya hangi protokolleri destekliyor?
Kreya; gRPC, REST, GraphQL, WebSocket ve Server-Sent Events'i destekler. gRPC desteği, proto içe aktarma, sunucu yansıtma ve dört akışlı çağrı türünün tamamı ile en derin olanıdır.
Kreya sürüm kontrolünü nasıl yönetir?
Kreya her projeyi diskte git-diff edilebilir JSON dosyaları olarak saklar. Bunları deponuza taahhüt eder, çekme isteklerindeki değişiklikleri inceler ve standart Git komutlarıyla düzenlemeleri geri alırsınız.
Kreya API istemcisi, Kreya moda markasıyla ilişkili mi?
Hayır. Burada bahsedilen Kreya, riok GmbH tarafından yapılan kreya.app adresindeki API istemcisidir. Aynı adı taşıyan herhangi bir moda veya güzellik markasıyla bağlantısı yoktur.