Bir API Test Aracı Yalnızca Neyi Test Ettiğinizi Biliyorsanız Yararlıdır
Postman, Insomnia, Bruno, Hoppscotch: bunlardan herhangi birini seçin. İki dakika içinde ücretsiz bir spec oluşturun, hiç kayıt olmadan, ve aracı gerçek bir şeye vuracak bir şey verin.
Test etmek, geliştirici yapması gereken en yaygın API görevi
Bir API test aracının gerçekten iyi olduğu işler
Bir uç noktasını hızlı kontrol edin
İstek gönderin, yanıtı okuyun, bir başlığı ayarlayın. Tek seferlik bir kontrol için bir kez kullanılır bir script yazmaktan daha hızlı.
Akışı kaydedin, tekrar oynatın
Yetkilendirme çağrısı, sonra gerçek istek, sonra temizlik. Sıra bir kez kaydedin, API değiştiğinde her seferinde tekrar oynatın.
Bir kullanıcı yapmadan önce gerilemeyi yakalayın
Dağıtmadan önce kaydedilmiş bir koleksiyonu çalıştırmak, kırdığınız uç noktayı işaretler, hatırlamanıza gerek yoktur.
Henüz inşa edilmemiş arka ucu taklit edin
Ön ucunuzun beklediği yanıt şeklini taklit edin, buna karşı oluşturun, gerçek API varolduğunda değiştirin.
Gerçekten gönderecek kimlik doğrulama akışını test edin
OAuth yönlendirmeleri, yenileme belirteçleri, sona eren anahtarlar: uygulama kodunuzun içine gömülmemiş, bunun dışında test etmeye değer.
Çalışan bir örneği başka birine verin
Paylaşılan bir koleksiyon, API'yi düz yazıdan daha iyi belgeler ve gerçekten çalışır.
Beş gerçek takas, tek bir doğru cevap değil
Hangi isim en tanıdık olduğu değil, başka kimse koleksiyona ihtiyaç duyacak ve belirteçlerinizin nereye yaşamak istediğinize göre seçin.
| Özellik | Postman | Insomnia | Bruno | Hoppscotch |
|---|---|---|---|---|
| Koleksiyonlar yaşıyor | Varsayılan olarak buluta senkronize edilir | Yerel olarak, isteğe bağlı bulut senkronizasyonu ile | Kodunuzun yanında düz dosyalar, git dostu | Hesabınızda veya kendi barındırılan bir örnekte |
| Ücretsiz seviye | Bulut senkronizasyonu ve işbirlikçileri sınırlı | Tek kullanıcılı yerel kullanım için cömert | Tam açık kaynaklı, sınırlama yok | Açık kaynaklı, sınırlama yok |
| CI'de çalışır | Newman | Inso CLI | Bruno CLI | hoppscotch-cli |
| En iyi uyum | Bir çalışma alanını paylaşan ekipler | Git'te API koleksiyonunu sürümlenmiş istiyorsan isteyen bağımsız geliştirici | Geliştirici API koleksiyonunu git'te sürümlenmiş isteyenler | Tarayıcıda kalmayı tercih eden geliştirici |
Test aracını seçmeden önce API'yi kapsamını belirleyin
Olağan başarısızlık modu yanlış aracı seçmek değildir, hiçbiri asla kapsamı belirlenmemiş bir API'ye karşı açılmaktır. Üç gerçek uç noktanın adını, yetkilendirme modelini ve tüm özelliğin bağlı olduğu tek akışı adlandıramıyorsanız, hiçbir test aracı sizi kurtarmaz: henüz tasarlanmamış bir şeyi test ediyorsunuz. whatshouldibuildnext.com'un oluşturucusu, kaba bir proje fikrini yaklaşık iki dakika içinde adlandırılmış uç noktalar ve önerilen bir stack içeren bir speca dönüştürür; böylece ilk isteği yazmadan önce Postman, Insomnia veya Bruno'yu açacak somut bir şey vardır.
- Ücretsiz, istemci tarafı, hiç kayıt yok
- Test etmeniz gereken gerçek uç noktaları adlandırır
- Önce taklit edilmeye değer tek entegrasyonu işaretler
Gerçek soru belirteçlerinizin nereye yaşadığıdır
Hangi araç konuşması her zaman iki endişeye çöker: işbirliği hesap değerinde mi, ve sırlar nerede yaşıyor? Postman'in bulut sinkronizasyonu, bir istemci veya takım arkadaşı ile koleksiyonu paylaşmayı kolay hale getirir ve aynı zamanda hazırlama API anahtarınız artık deponuzun dışında bir yerde yaşıyor. Bruno ve Hoppscotch'un yerel ilk veya kendi barındırılan seçenekleri koleksiyonları kodunuzun yanında düz dosya olarak tutar, Postman'in özellik setinden daha hafif bir özellik seti maliyetinde. Her iki şekilde, keys ve tokens için ortam değişkenlerini kullanın, kaydedilmiş bir isteğe asla yapıştırılan bir literal değer değil, sonra da paylaşıyor veya senkronize edebilir.
Bir öğleden sonrada API'yi test etme
-
1
Önce uç noktaları kapsamını belirleyin
Gerçekten neyi oluşturduğunuzu adlandırın: 3-5 rota, önemli bir akış ve henüz kasıtlı olarak ele almadığınız şey.
-
2
Mutlu yolu elle test edin
Uç nokta başına bir istek, gerçek yükler, gerçek yanıtı okuyun. Araçların çoğu burada emeklerini çeker.
-
3
Bunu bir koleksiyon olarak kaydedin
İstekleri gruplandırın, yetkilendirme adımını ekleyin, birbirlerinin çıktısına bağlı olanları zincirleyin.
-
4
Başarısız olması gereken istekleri ekleyin
Yanlış belirteç, eksik alan, hız sınırı. Sadece mutlu yolu ele alan bir API ilk hafta başka biri kullanırsa kırılır.
-
5
Önemli olana kadar CI'ye bağlayın
Gün bire değil. API gerçek kullanıcıları olduğunda, kırılan uç nokta yapıyı değil, birinin öğleden sonrasını başarısız kılar.
Yaygın sorular
Adanmış bir API test aracına ihtiyacım var mı, yoksa curl yeterli mi?
Bağımsız bir yan proje için hangi API test aracını seçmeliyim?
Kaydedilen isteklerdeki API anahtarlarımı bir test aracında depolamak güvenli mi?
Bir API test aracı otomatikleştirilmiş testlerin yerini alabilir mi?
Kumaş bir API test aracı ne kadar maliyetlidir?
Aslında ilk olarak ne test etmeliyim?
Bunu gerçekten uygulamak için ne inşa etmeliyim?
API'yi kapsamını belirleyin, sonra test aracını seçin
Ücretsiz spec oluşturucusu, istemci tarafı, hiç kayıt yok. Uç noktaları ve önerilen yığını alın, sonra zaten kullandığınız hangi aracı açın.