fTL;DR
Insomnia 8.0'a yükselttiyseniz ve koleksiyonlarınıza erişimi kaybettiyseniz, verileriniz muhtemelen hala diskte duruyor. Bu rehber size verilerinizi nasıl bulacağınızı, SQLite veritabanından nasıl kurtaracağınızı ve Apidog veya başka bir alternatife temiz bir şekilde nasıl taşıyacağınızı gösteriyor. Yedek dosyalarınızın üzerine yazabilecek herhangi bir yeni güncelleme yüklemeden önce harekete geçin.
Giriş
Insomnia 8.0 güncellemesi Eylül 2023'te zorunlu bulut girişiyle birlikte yayınlandı. Birçok kullanıcı için bu yükseltme kafa karıştırıcı bir sonuç doğurdu: uygulama bir giriş ekranına açıldı ve aylardır veya yıllardır oluşturdukları koleksiyonlar kaybolmuş gibi görünüyordu.
Bazı veri kayıpları gerçekti – özellikle belirli sistemlerde geçici depolamanın veriyi bozduğu durumlar. Ancak birçok durumda, temel SQLite veritabanı dosyaları diskte sağlam bir şekilde duruyordu, sadece yeni kullanıcı arayüzü aracılığıyla bir Kong hesabı olmadan erişilemez durumdaydı.
Bu rehber her iki durum için de geçerlidir. Verileriniz hala oradaysa, onu nasıl çıkaracağınızı öğreneceksiniz. Geçici depolama verilerinizi gerçekten kaybettiyse, hangi kurtarma seçeneklerinin bulunduğunu ve daha güvenilir yerel öncelikli bir modele sahip bir araca geçerek aynı sorunu gelecekte nasıl önleyeceğinizi öğreneceksiniz.
Adım 1: Mevcut Insomnia veritabanı dosyalarınızı bulun
Başka hiçbir şey yapmadan önce – yeniden yüklemeden, bir Kong hesabı oluşturmadan, Insomnia'yı tekrar açmadan önce – mevcut veritabanı dosyalarınızı bulun ve güvenli bir konuma kopyalayın.
Insomnia, verilere sürüme ve işletim sistemine bağlı olarak farklı konumlarda depoladı.
macOS:
~/Library/Application Support/Insomnia/
Windows:
C:\Users\[KullanıcıAdı]\AppData\Roaming\Insomnia\
Linux:
~/.config/Insomnia/
Bu dizinin içinde şu dosyaları arayın:
insomnia.db– ana veritabanı (eski sürümler)core/adında.dbdosyalarını içeren bir dizin – 8.0 öncesi sürümlerde yaygınworkspaces/– önceki dışa aktarımlardan dışa aktarılmış JSON dosyalarını içerebilir
Tüm Insomnia uygulama destek dizinini hemen bir yedekleme konumuna kopyalayın. Bu adımı atlamayın. Herhangi bir ek yükseltme yaparsanız veya Insomnia'yı kaldırıp yeniden yüklerseniz, bu dosyaların üzerine yazılma veya silinme riski vardır.
Adım 2: Insomnia kullanıcı arayüzü aracılığıyla kurtarma denemesi yapın
Henüz bir Kong hesabına giriş yapmadıysanız, önce geçici depolama yolunu deneyin. Insomnia giriş ekranını gösterdiğinde, "Hesapsız kullan" veya "Yerel depolama ile devam et" gibi bir bağlantı veya düğme arayın. Tam ifade sürümler arasında değişmiştir.
Uygulamaya giriş yapmadan erişebilirseniz, hemen her çalışma alanını dışa aktarın:
- Sol kenar çubuğundaki bir çalışma alanı adına tıklayın
- Çalışma alanı menüsüne gidin (üç nokta veya dişli çark simgesi)
- “Dışa Aktar”ı seçin
- “Insomnia v4 (JSON)” formatını seçin
- Dosyayı güvenli bir yere kaydedin
- Her çalışma alanı için tekrarlayın
Zaten bir Kong hesabınız varsa ve giriş yapabiliyorsanız, aynı dışa aktarma işlemini yapın. Giriş yapmış deneyim, senkronize edilmiş çalışma alanlarınıza erişim sağlar; bu, daha önce senkronize ettiyseniz diskteki verilerden daha eksiksiz olabilir.
Adım 3: Verileri doğrudan SQLite veritabanından kurtarın
Kullanıcı arayüzü verilerinize erişim sağlamıyorsa, doğrudan veritabanı dosyasından çıkarabilirsiniz. Bu, ücretsiz bir SQLite tarayıcı aracı gerektirir.
SQLite için DB Browser'ı yükleyin. sqlitebrowser.org adresinden indirin. Ücretsiz, açık kaynaklıdır ve macOS, Windows ve Linux için mevcuttur.
Veritabanı dosyanızı açın. DB Browser'da, Dosya > Veritabanı Aç'a gidin ve Insomnia uygulama destek dizinine gidin. insomnia.db veya orada bulduğunuz herhangi bir .db dosyasını açın.
Şemayı keşfedin. Insomnia'nın veritabanında önemseyeceğiniz birkaç tablo bulunmaktadır:
Workspace– üst düzey çalışma alanlarınızRequestGroup– çalışma alanları içindeki klasörlerRequest– bireysel isteklerEnvironment– ortam değişkeni setleriResponse– depolanan yanıt geçmişi (kurtarılması isteğe bağlı)
Verileri dışa aktarın. Verileri Gözat sekmesinde, her tabloyu seçin ve ham veriyi kaydetmek için Dosya > Dışa Aktar > Tabloyu CSV olarak kullanın. İstekler için ana alanlar name, url, method, headers (JSON olarak depolanır) ve body'dir.
Koleksiyonları yeniden oluşturun. CSV yaklaşımı, yeniden oluşturmanız için ham veriyi sağlar. Zahmetli ama güvenilirdir. Programatik bir yaklaşım için, veritabanını sorgulamak ve bir dışa aktarma betiği yazmak için Python'ın sqlite3 modülünü kullanabilirsiniz.
İşte eski bir Insomnia veritabanından istekleri çıkarmak için minimal bir Python betiği:
import sqlite3
import json
conn = sqlite3.connect('/path/to/insomnia.db')
cursor = conn.cursor()
cursor.execute("SELECT name, url, method, headers, body FROM Request")
rows = cursor.fetchall()
for row in rows:
print(f"Ad: {row[0]}")
print(f"Metot: {row[2]} {row[1]}")
if row[3]:
headers = json.loads(row[3])
for h in headers:
print(f" Başlık: {h.get('name')}: {h.get('value')}")
print()
conn.close()
Alan adlarını DB Browser'da gördüğünüz şeye göre ayarlayın – tam şema Insomnia sürümleri arasında farklılık gösteriyordu.
Adım 4: Veritabanı bozulursa yedeklerden kurtarın
Veritabanı dosyası bozulmuşsa, seçenekler daha sınırlıdır.
Time Machine veya sistem yedeklemelerini kontrol edin. macOS Time Machine, Windows Dosya Geçmişi ve çoğu bulut yedekleme hizmeti (Backblaze, iCloud Drive vb.), yükseltmeden önceki Insomnia dizininizin anlık görüntülerini içerebilir. Uygulama destek dizininin 8.0 öncesi sürümünü ayrı bir konuma geri yükleyin, ardından bu dosyaları okumak için DB Browser'ı kullanın.
Git geçmişini kontrol edin. Bazı ekipler Insomnia dışa aktarımlarını bir git deposunda sürümlendirir. Kuruluşunuz bunu yapıyorsa, dışa aktarım dosyaları git geçmişinden kurtarılabilir.
Insomnia dışa aktarım dosyalarını arayın. Geçmişte koleksiyonları manuel olarak dışa aktardıysanız, bu JSON dosyaları İndirilenler klasörünüzde veya bir proje dizininde duruyor olabilir. Dosya sisteminizde "insomnia" veya "_collection" içeren .json uzantılı dosyaları arayın.
Adım 5: Apidog'a geçin
Verilerinizi Insomnia v4 JSON formatında (ya bir kullanıcı arayüzü dışa aktarımıyla ya da manuel olarak yeniden yapılandırılmış şekilde) elde ettikten sonra, Apidog'a geçiş birkaç dakika sürer.
Koleksiyonlarınızı içe aktarın.
- Apidog'u açın ve yeni bir proje oluşturun
- Proje ayarlarına veya kenar çubuğundaki içe aktarma seçeneğine gidin
- “İçe Aktar”ı seçin ve “Insomnia”yı işaretleyin
- Dışa aktardığınız JSON dosyasını yükleyin
- Apidog çalışma alanlarını, klasörleri, istekleri ve ortamları ayrıştıracaktır
Temiz bir şekilde aktarılanlar:
- HTTP istekleri (GET, POST, PUT, DELETE, PATCH)
- İstek başlıkları
- İstek gövdeleri (JSON, form verisi, çok parçalı)
- URL parametreleri ve yol değişkenleri
- Ortam değişkenleri ve değerleri
- Klasör yapısı
Manuel inceleme gerektirenler:
- İstek öncesi ve istek sonrası betikler (JavaScript). Apidog benzer bir betik modelini kullanır ancak söz dizimi ayarlama gerektirebilir.
- Insomnia eklentilerine dayanan özel kimlik doğrulama akışları
- Yanıt testi onaylamaları – bunlar Apidog'un test formatına yeniden girilmelidir
Ortamlarınızı kurun. İçe aktarma işleminden sonra, ortam değişkenlerinin doğru şekilde içe aktarıldığını kontrol edin. Ortamlar paneline gidin ve temel URL'leri, API anahtarlarını ve aktarılan tüm jetonları doğrulayın.
Ekip erişimini doğrulayın. Bir ekip çalışma alanını taşıyorsanız, Apidog isteğe bağlı bulut senkronizasyonu ile paylaşılan çalışma alanlarını destekler. Verilerin Apidog'un bulutuna senkronize olup olmadığını siz kontrol edersiniz. Ekipler için, senkronizasyonu bir kez etkinleştirmek, taşınan koleksiyonları paylaşmanın en kolay yoludur.
Birkaç isteği test edin. Koleksiyonunuzdan beş veya altı temsili istek seçin ve beklendiği gibi çalıştıklarını onaylamak için bunları çalıştırın. Kimlik doğrulama başlıklarına ve ortam değişkeni değiştirmelerine dikkat edin.
Gelecekte bu sorunu önlemek
Insomnia 8.0 durumundan çıkarılacak temel ders, kritik çalışma verilerinizi yedekleme stratejisi olmadan tek bir araca emanet etmenin riskli olduğudur – hangi aracı kullanırsanız kullanın.
Gelecekte sizi koruyacak birkaç alışkanlık:
Düzenli olarak dışa aktarın. Koleksiyonlarınızın aylık dışa aktarımını bir yedekleme klasörüne veya bir git deposuna planlayın. Bu iki dakika sürer ve ne olursa olsun size bir kurtarma yolu sunar.
Yerel öncelikli araçları seçin. Apidog varsayılan olarak verileri yerel olarak depolar. Bruno koleksiyonları diskte düz dosyalar olarak depolar. Her ikisi de verilerinizi bir satıcının bulutuna bağımlı olmadan görmenize ve yedeklemenize olanak tanır.
Yükseltmeden önce veri modelini kontrol edin. Büyük bir sürüm yayınlandığında, güncellemeden önce geçiş notlarını okuyun. Sürüm, verilerin nerede veya nasıl depolandığını değiştiriyorsa, yükle düğmesine tıklamadan önce etkilerini anlayın.
Sıkça Sorulan Sorular
Kong'a giriş yapmadan Insomnia verilerini kurtarabilir miyim?Evet, eğer veritabanı dosyalarınız hala diskte duruyorsa. Insomnia uygulama destek dizininizdeki .db dosyasını açmak ve verileri doğrudan tablolardan dışa aktarmak için SQLite için DB Browser'ı kullanın.
Insomnia verilerini dışa aktarırken hangi formatı kullanmalıyım?Insomnia v4 JSON formatını kullanın. Bu, en yaygın desteklenen formattır ve Apidog, Postman ve diğer araçlar tarafından içe aktarılabilir.
Ortam değişkenlerim Apidog'a aktarılacak mı?Çoğu durumda evet. Insomnia ortamları v4 JSON formatının bir parçası olarak dışa aktarılır ve Apidog bunları içe aktarır. Özellikle hassas jetonlar için değerlerin doğru olduğunu onaylamak amacıyla içe aktarılan ortamları gözden geçirin.
Insomnia'nın geçici depolaması ile diğer araçlardaki yerel depolama arasındaki fark nedir?Insomnia'nın geçici depolaması, güvenilirlik sorunları olan bir geri dönüş moduydu. Apidog ve Bruno, yerel depolamayı bir geri dönüş olarak değil, birincil model olarak ele alır. Veriler her kaydetmede diske yazılır, bellekte tutulmaz.
macOS üzerinde SQLite için DB Browser kullanabilir miyim?Evet. SQLite için DB Browser, projenin web sitesi aracılığıyla ve Homebrew (brew install db-browser-for-sqlite) üzerinden macOS için mevcuttur.
Insomnia'dan Apidog'a geçiş ne kadar sürer?50-200 isteklik tipik bir koleksiyon için içe aktarma işlemi beş dakikadan az sürer. Betikleri ve kimlik doğrulama akışlarını gözden geçirme ve ayarlama, karmaşıklığa bağlı olarak daha uzun sürebilir.
