Insomnia, uygulama programlama arayüzlerini geliştirmek, test etmek ve hata ayıklamak amacıyla geliştirilen ücretsiz ve açık kaynaklı bir API istemcisidir. Kong tarafından geliştirilen yazılım, özellikle web geliştiricileri, yazılım mühendisleri ve sunucu uygulamaları üzerinde çalışan ekipler için hazırlanmıştır. API isteklerinin oluşturulmasını, sunucu yanıtlarının incelenmesini ve farklı bağlantı yöntemlerinin test edilmesini grafiksel bir arayüz üzerinden gerçekleştirir. Geleneksel komut satırı araçlarına alternatif olarak kapsamlı bir API geliştirme ve test ortamı sunar.
Uygulama, REST ve HTTP tabanlı servislerin yanında GraphQL, gRPC, WebSocket ve Server-Sent Events gibi iletişim yöntemlerini destekler. Kullanıcılar GET, POST, PUT, PATCH ve DELETE gibi HTTP istekleri oluşturabilir. İstek başlıkları, URL parametreleri, çerezler ve gövde verileri ayrıntılı biçimde düzenlenebilir. JSON, XML, form verileri ve farklı içerik türleriyle çalışılabilir. Sunucudan dönen yanıtlar durum kodu, başlık bilgileri, içerik ve yanıt süresi açısından incelenebilir.
Insomnia, farklı sunucu ortamlarının yönetilmesini sağlayan değişken sistemine sahiptir. Kullanıcılar geliştirme, test ve üretim ortamları için farklı bağlantı adresleri ve yapılandırmalar tanımlayabilir. Aynı API isteği, ortam değişkenleri değiştirilerek farklı sunuculara gönderilebilir. Kimlik doğrulama işlemleri için API anahtarları, temel HTTP kimlik doğrulaması ve OAuth 2.0 gibi yöntemlerden yararlanılabilir. Bu özellik, birden fazla ortamda çalışan uygulamaların test edilmesini kolaylaştırır.
Program, API isteklerinin koleksiyonlar içerisinde düzenlenmesini destekler. Kullanıcılar belirli projelere ait istekleri gruplandırabilir ve tekrar kullanabilir. Koleksiyon çalıştırıcısı aracılığıyla birden fazla istek belirli bir sırayla yürütülebilir. Test senaryoları hazırlanarak sunucudan dönen sonuçların beklenen değerleri karşılayıp karşılamadığı kontrol edilebilir. Bu sistem, API değişikliklerinin mevcut işlevler üzerindeki etkilerini değerlendirmek ve tekrarlanan test işlemlerini otomatikleştirmek için kullanılabilir.
Insomnia, OpenAPI standardıyla çalışan geliştirme araçları da sunar. Kullanıcılar API tanımlarını oluşturabilir, düzenleyebilir ve görsel önizleme üzerinden inceleyebilir. Desteklenen OpenAPI belgelerinden istek koleksiyonları oluşturulabilir. Mock sunucular aracılığıyla gerçek sunucu uygulaması tamamlanmadan örnek API yanıtları üretilebilir. Böylece ön yüz ve arka uç geliştirme süreçleri daha bağımsız biçimde yürütülebilir. Komut satırı aracı olan Inso CLI, API testlerinin ve doğrulama işlemlerinin otomatik dağıtım süreçlerine eklenmesini sağlar.
Uygulama, proje verilerinin saklanması için farklı yöntemler sunar. Local Vault kullanılarak koleksiyonlar ve diğer proje bilgileri yerel olarak saklanabilir. Git Sync desteği sayesinde API projeleri sürüm kontrol sistemleriyle birlikte yönetilebilir. Bulut eşzamanlama seçenekleri, ekip üyelerinin ortak projeler üzerinde çalışmasına olanak tanır. Eklenti sistemi aracılığıyla farklı kimlik doğrulama yöntemleri, özel veri işlemleri ve yeni geliştirme araçları eklenebilir. Bazı gelişmiş iş birliği özellikleri kullanılan hizmet ve abonelik türüne bağlıdır.
Electron, React ve TypeScript teknolojilerinden yararlanılarak geliştirilen Insomnia; Windows, macOS ve Linux işletim sistemlerini destekler. Windows 10 ve üzeri sistemler için hazır EXE kurulum paketi bulunmaktadır. Apache-2.0 lisansı altında dağıtılan uygulama, API tasarımı, test otomasyonu ve hata ayıklama işlemlerini aynı masaüstü ortamında birleştiren kapsamlı bir geliştirici aracıdır.
Uygulama, REST ve HTTP tabanlı servislerin yanında GraphQL, gRPC, WebSocket ve Server-Sent Events gibi iletişim yöntemlerini destekler. Kullanıcılar GET, POST, PUT, PATCH ve DELETE gibi HTTP istekleri oluşturabilir. İstek başlıkları, URL parametreleri, çerezler ve gövde verileri ayrıntılı biçimde düzenlenebilir. JSON, XML, form verileri ve farklı içerik türleriyle çalışılabilir. Sunucudan dönen yanıtlar durum kodu, başlık bilgileri, içerik ve yanıt süresi açısından incelenebilir.
Insomnia, farklı sunucu ortamlarının yönetilmesini sağlayan değişken sistemine sahiptir. Kullanıcılar geliştirme, test ve üretim ortamları için farklı bağlantı adresleri ve yapılandırmalar tanımlayabilir. Aynı API isteği, ortam değişkenleri değiştirilerek farklı sunuculara gönderilebilir. Kimlik doğrulama işlemleri için API anahtarları, temel HTTP kimlik doğrulaması ve OAuth 2.0 gibi yöntemlerden yararlanılabilir. Bu özellik, birden fazla ortamda çalışan uygulamaların test edilmesini kolaylaştırır.
Program, API isteklerinin koleksiyonlar içerisinde düzenlenmesini destekler. Kullanıcılar belirli projelere ait istekleri gruplandırabilir ve tekrar kullanabilir. Koleksiyon çalıştırıcısı aracılığıyla birden fazla istek belirli bir sırayla yürütülebilir. Test senaryoları hazırlanarak sunucudan dönen sonuçların beklenen değerleri karşılayıp karşılamadığı kontrol edilebilir. Bu sistem, API değişikliklerinin mevcut işlevler üzerindeki etkilerini değerlendirmek ve tekrarlanan test işlemlerini otomatikleştirmek için kullanılabilir.
Insomnia, OpenAPI standardıyla çalışan geliştirme araçları da sunar. Kullanıcılar API tanımlarını oluşturabilir, düzenleyebilir ve görsel önizleme üzerinden inceleyebilir. Desteklenen OpenAPI belgelerinden istek koleksiyonları oluşturulabilir. Mock sunucular aracılığıyla gerçek sunucu uygulaması tamamlanmadan örnek API yanıtları üretilebilir. Böylece ön yüz ve arka uç geliştirme süreçleri daha bağımsız biçimde yürütülebilir. Komut satırı aracı olan Inso CLI, API testlerinin ve doğrulama işlemlerinin otomatik dağıtım süreçlerine eklenmesini sağlar.
Uygulama, proje verilerinin saklanması için farklı yöntemler sunar. Local Vault kullanılarak koleksiyonlar ve diğer proje bilgileri yerel olarak saklanabilir. Git Sync desteği sayesinde API projeleri sürüm kontrol sistemleriyle birlikte yönetilebilir. Bulut eşzamanlama seçenekleri, ekip üyelerinin ortak projeler üzerinde çalışmasına olanak tanır. Eklenti sistemi aracılığıyla farklı kimlik doğrulama yöntemleri, özel veri işlemleri ve yeni geliştirme araçları eklenebilir. Bazı gelişmiş iş birliği özellikleri kullanılan hizmet ve abonelik türüne bağlıdır.
Electron, React ve TypeScript teknolojilerinden yararlanılarak geliştirilen Insomnia; Windows, macOS ve Linux işletim sistemlerini destekler. Windows 10 ve üzeri sistemler için hazır EXE kurulum paketi bulunmaktadır. Apache-2.0 lisansı altında dağıtılan uygulama, API tasarımı, test otomasyonu ve hata ayıklama işlemlerini aynı masaüstü ortamında birleştiren kapsamlı bir geliştirici aracıdır.
