Postman, API'yi kod yazmadan keşfetmek, isteklerinizi koleksiyon halinde saklamak ve ekiple paylaşmak için kullanışlıdır. Sertifika API'leri için de aynı yaklaşım geçerlidir.
Kurulum adımları
- Yeni bir koleksiyon oluşturun, örneğin "SSL API".
- Bir ortam (Environment) tanımlayın ve
base_url,api_tokendeğişkenlerini ekleyin. - Koleksiyonun Authorization sekmesinde Bearer Token seçip
{{api_token}}yazın. - İstekleri
{{base_url}}/ordersgibi değişkenlerle tanımlayın.
Test/canlı farkı için iki ayrı ortam oluşturup aralarında geçiş yapmak, yanlışlıkla canlıya sipariş vermeyi önler.
Testler ve değişken aktarımı
Yanıtı doğrulayan ve sonraki isteğe değer aktaran küçük bir test betiği:
pm.test("Durum 200", function () {
pm.response.to.have.status(200);
});
const json = pm.response.json();
pm.environment.set("siparis_id", json.id);
Alan adları sağlayıcı yanıtına göre değişir. Böylece "sipariş oluştur" isteğinden dönen kimlik, "durum sorgula" isteğinde {{siparis_id}} olarak kullanılabilir.
İyi uygulamalar
- Gizli değerleri "secret" türünde saklayın; koleksiyonu dışa aktarırken anahtarların dosyaya sızmadığından emin olun.
- Canlı ortamda ödeme gerektiren istekleri çalıştırmadan önce iki kez kontrol edin.
- Koleksiyon çalıştırıcıyı (Runner) yalnızca salt okunur istekler için toplu kullanın.
- SSL sertifikası doğrulama ayarını (Settings > SSL certificate verification) açık tutun.
Ne zaman kod yazmaya geçilir?
İstek akışı netleşince aynı çağrıları Postman'ın "Code" özelliğiyle cURL, PHP veya Python kod parçasına dönüştürebilirsiniz. Gerçek entegrasyonda zaman aşımı, yeniden deneme ve günlükleme kodda yönetilmelidir.
CSR hazırlamak için CSR oluşturucu, genel rehberler için bilgi bankası kullanılabilir.
Sık sorunlar
- 401 alıyorsanız ortamın seçili olduğunu ve değişkenin dolu olduğunu kontrol edin.
- Gövde gönderirken Body sekmesinde raw ve JSON seçili olmalıdır.
- Koleksiyonu paylaşırken ortam dosyasını değil yalnızca koleksiyonu dışa aktarın.