Değişkenler, bir değere isim vermenizi ve ihtiyacınız olan her yerde yeniden kullanmanızı sağlar.
Örneğin, sık sık değişen bir API anahtarını her isteğe yapıştırmak yerine, ACCESS_TOKEN gibi bir değişken tanımlayın ve isteklerinizde {{ACCESS_TOKEN}} kullanın. Anahtarın süresi dolduğunda, değişkeni bir kez güncelleyin ve onu kullanan tüm istekler otomatik olarak yeni değeri alacaktır.
Değişken Türlerine Genel Bakış
Apidog, her biri belirli senaryolar için tasarlanmış çeşitli değişken türlerini destekler. Kullanabileceğiniz türler şunlardır: ekip düzeyinde genel değişkenler, proje düzeyinde genel değişkenler, modül değişkenleri, ortam değişkenleri, test verisi değişkenleri ve yerel değişkenler.
Genel Değişkenler
Genel değişkenler, verileri geniş çapta paylaşmanızı sağlar. İki türü vardır:
Proje Düzeyinde Genel Değişkenler: Mevcut projeyle sınırlıdır. Aynı proje içindeki istekler arasında veri aktarımı için mükemmeldir. Örneğin, bir oturum açma uç noktasından alınan bir anahtarı proje düzeyinde genel bir değişken olarak saklayın, ardından bu projede diğer isteklerde yeniden kullanın.
Ekip Düzeyinde Genel Değişkenler: Bir ekipteki tüm projeler arasında paylaşılır. Projeler arası işbirliği için idealdir. Örneğin, bir kimlik doğrulama hizmeti birden fazla proje tarafından kullanılan bir anahtar veriyorsa, bunu bir ekip genel değişkeni olarak saklayın.
İzin notu: Normal üyeler yalnızca mevcut ekip düzeyindeki genel değişkenlerin güncel değerlerini görüntüleyebilir ve değiştirebilir. Değişken ekleyemez/silemez veya yeniden adlandıramazlar. Yalnızca ekip yöneticileri, Ekip Kaynakları → Değişkenler bölümünden ekip düzeyindeki değişkenleri tam olarak yönetebilir.
Modül Değişkenleri
Modül değişkenleri belirli bir modülle sınırlıdır. Bir Postman Koleksiyonu'nu içe aktarırsanız, koleksiyon değişkenleri Apidog modül değişkenleri olarak içe aktarılır.
Modüle özel yapılandırma için harikadırlar. Örneğin, bir projenin kullanıcılar, siparişler ve ürünler için ayrı modülleri olabilir—her biri kendi yapılandırmasını modül değişkenlerinde tutabilir.
Modül değişkenlerini kullanmak için Apidog'un güncel olduğundan emin olun.
Ortam Değişkenleri
Ortam değişkenleri muhtemelen en çok kullandığınız türdür. Her istek için yapılandırmayı değiştirmeden ortamlar arasında geçiş yapmanızı sağlarlar.
Uygulamada, genellikle birden fazla ortamınız (yerel, test, hazırlık, üretim) bulunur. Her birinin farklı sunucu adresleri, veritabanı bağlantıları veya üçüncü taraf yapılandırmaları vardır. Ortam değişkenleri ile bunlar arasında anında geçiş yapabilirsiniz.
Not: Aynı anda yalnızca bir ortam aktif olabilir. Bir ortam seçtiğinizde, içinde tanımlanan tüm değişkenler geçerli olur.
Test Verisi Değişkenleri
Test verisi değişkenleri, veri odaklı testleri destekler. Aynı uç noktayı birçok veri kümesiyle test etmeniz gerektiğinde, bu sizin dostunuzdur.
Birden çok satır (veya nesne) içeren bir CSV veya JSON dosyası hazırlayın. Otomatik bir test senaryosunda, dosyayı içe aktarın ve Apidog her satırı bir değişken kümesi olarak yineleyecek ve her biri için testi yürütecektir.
Yerel Değişkenler
Yerel değişkenlerin ömrü en kısadır; yalnızca tek bir istek veya test çalıştırması sırasında geçerlidirler. Yürütme sonrası kaybolurlar.
Yerel değişkenler en yüksek önceliğe sahip olduğundan, diğer değişken türlerini anlık olarak geçersiz kılmak için mükemmeldirler. Örneğin, ortamınız user_id değerini tanımlar, ancak özel bir test için farklı bir değere ihtiyacınız varsa, ortamı değiştirmek yerine aynı ada sahip bir yerel değişken ayarlayın.
Değişken Önceliği
Birden fazla değişken aynı adı paylaştığında, Apidog bunları önceliğe göre (en yüksekten en düşüğe) çözer: Yerel Değişkenler > Test Verisi Değişkenleri > Ortam Değişkenleri > Modül Değişkenleri > Proje Düzeyinde Genel Değişkenler > Ekip Düzeyinde Genel Değişkenler
Örnek: userId adında üç değişken tanımlarsanız:
- Proje düzeyinde genel değişkenler
userId = 1000 - Modül değişkenleri:
userId = 2000 - Ortam değişkenleri:
userId = 3000
Bir istekte {{userId}} kullandığınızda, etkin değer 3000 (ortamdan) olur. Ortam değeri yoksa, modül değerine (2000), ardından proje genel değerine (1000) geri döner.
Başlangıç Değerleri ve Güncel Değerler
Genel, modül ve ortam değişkenlerinin hem başlangıç hem de güncel değerleri vardır; bu, ekip paylaşımını kişisel gizlilikle dengeler.
- Başlangıç değerleri Apidog'un sunucularında bulunur ve ekip arkadaşlarınızla senkronize edilir. Bunları test sunucusu URL'leri ve genel API anahtarları gibi paylaşılan yapılandırmalar için kullanın.
- Güncel değerler yalnızca cihazınızda bulunur. Bunları kişisel API anahtarları, parolalar veya özel ortam ayarları gibi sırlar için kullanın.
Güncel bir değer mevcut olduğunda, Apidog onu tercih eder. Güncel değer boşsa, Apidog başlangıç değerini kullanır. Güncel değerin başlangıç değerini takip etmesini mi istiyorsunuz? Yeniden bağlamak için güncel değerin yanındaki bağlantı simgesine tıklayın.
Güncel değerler cihazınızda saklanır ve önbelleği temizlerseniz veya cihaz değiştirirseniz kaybolabilir. Apidog web sürümünde, tarayıcıda saklanırlar. Yeni bir cihaza geçmek için, güncel değerleri taşımak üzere ortamları dışa/içe aktarın.
Not: Apidog CLI ile otomatik testler çalıştırırken önemli bir farkı unutmayın: Apidog istemcisi yürütme sırasında güncel değerleri kullanırken, CLI başlangıç değerlerini kullanır. İstemci ve CLI arasındaki sonuçlar farklılık gösteriyorsa, bu yaygın bir nedendir.
Değişkenleri Ayarlama Yolları
Değerin nereden geldiğine ve nasıl kullanacağınıza en uygun yöntemi seçin.
Değişkenleri Doğrudan Ortam Yönetimi Sayfasında Ayarlayın
En basit yöntem. Ortam Yönetimi düğmesine (sağ üst) tıklayın, genel veya belirli bir ortama geçin, ardından adları ve değerleri ekleyin.
Bu yöntem, veritabanı bağlantıları gibi kararlı yapılandırmalar için harikadır. Hem başlangıç (paylaşılan) hem de güncel (özel) değerleri ayarlayabilirsiniz.
"Değişkeni Sakla" Özelliğini Kullanın
Genellikle, değişken değeri bir yanıttan gelir—tıpkı bir oturum açma uç noktasından gelen bir anahtar veya bir kullanıcı oluşturma uç noktasından gelen bir kullanıcı kimliği gibi. Yeni bir değişken ayarlamak için Post Processors'daki görsel "Değişkeni Sakla" özelliğini kullanın.
Bir isteğin Post Processors'ında "Değişkeni Sakla"yı ekleyin, kaynağı (genellikle JSON yanıtı) seçin ve JSONPath kullanarak alanı seçin.
Örneğin, yanıt JSON'ı şöyle ise:
{
"user": {
"id": "69",
"email": "Ralph85@gmail.com",
"first_name": "Katlynn",
"last_name": "Reichert",
"api_token": "dolore ut mollit Duis sit",
"created_at": "2025-09-19T01:03:50.236Z",
"updated_at": "2025-05-10",
"deleted_at": "2025-09-18T18:30:51.217Z",
"role": "developer",
"metadata": {}
}
}Anahtarı çıkarmak için $.user.email kullanın.
Değişkenleri doğrudan bir isteğin yanıt bölümünden de ayarlayabilirsiniz.
Betikler Aracılığıyla Değişkenleri Ayarlayın
Daha karmaşık mantık için, Pre Processors veya Post Processors'da Özel Betik kullanın. Apidog, tüm değişken türlerini manipüle etmek için eksiksiz bir betik API'si sunar.
// Proje düzeyinde genel bir değişken ayarlayın
pm.globals.set('variable_key', 'variable_value');
// Ekip düzeyinde genel bir değişken ayarlayın (önce Ekip Kaynakları sayfasında tanımlanmalıdır)
pm.globals.set('variable_key', 'variable_value', 'TEAM');
// Bir ortam değişkeni ayarlayın
pm.environment.set('variable_key', 'variable_value');
// Bir modül değişkeni ayarlayın
pm.moduleVariables.set('variable_key', 'variable_value');
// Yerel bir değişken ayarlayın
pm.variables.set('variable_key', 'variable_value');Nesneleri veya dizileri saklarken, önce onları string'e dönüştürün ve okurken ayrıştırın. Örneğin:
pm.environment.set('user', JSON.stringify(userObj));
const users = JSON.parse(pm.environment.get('user'));Not: Betikler yalnızca değişkenlerin güncel değerlerini ayarlayabilir. Başlangıç değerleri Ortam Yönetimi Sayfasında ayarlanmalıdır.
Veritabanı Verilerini Değişken Olarak Kullanın
Apidog, verileri doğrudan bir veritabanından çekebilir ve değişken olarak ayarlayabilir—gerçek kayıtlara dayanan testler için harikadır.
Post Processors'da bir Veritabanı İşlemi ekleyin, bağlantıyı yapılandırın ve SQL'i yazın. Ardından JSONPath kullanarak alanları değişkenlere çıkarın.
Değişkenleri Kullanma İpuçları
Değişkenler Nerede Çalışır
Değişkenler yalnızca bir istek gerçekten gönderildiğinde çözümlenir. Bu, onları başlıklar, parametreler, gövde, test senaryoları ve betiklerde—bir isteğin gönderilmesiyle ilgili herhangi bir yerde—kullanabileceğiniz anlamına gelir.
Apidog görsel öncelikli olduğu için basit bir kural: "Dinamik Değer" düğmesini görürseniz, orada değişkenleri kullanabilirsiniz.
Temel Sözdizimi
Bir değişkene başvurmak için çift süslü parantez kullanın: {{variableName}}. Bu, URL, başlıklar, parametreler ve gövdede çalışır.
Örneğin, parametrelerde:
Ve gövdede:
JSON gövdeleri için notlar: string değişkenleri tırnak işaretlerine ihtiyaç duyar, sayısal değişkenler duymaz. Çift süslü parantezler JSON lint uyarılarını tetikleyebilir, ancak bunlar güvenle göz ardı edilebilir.
"Çözümlenmemiş değişken" görürseniz panik yapmayın. Post Processors veya betiklerde ayarlanan değişkenler, istek çalışana kadar var olmayabilir ve yerel değişkenler çalıştırma sonrası kaybolur. Doğrulamak için en iyi yol, isteği gerçekten göndermektir.
Bir Değişkenden Alt Alanları Çekme
Bazen değişkenleriniz sadece string veya sayı değil, nesneler veya diziler saklar. Örneğin, bir kullanıcı API'si genellikle id, ad, e-posta vb. içeren bir nesne döndürür.
Bu yanıt nesnesini user adında bir değişken olarak sakladığınızı varsayalım:
{
"id": 1001,
"name": "Joe",
"email": "joe@example.com",
"role": "admin"
}Belirli alanlara nokta notasyonu ile başvurabilirsiniz, örneğin {{user.id}} (1001) veya {{user.name}} ("Joe").
Diziler için benzerdir. Eğer users adında bir değişkeniniz varsa:
[
{"id": 1001, "name": "Joe"},
{"id": 1002, "name": "Rio"},
{"id": 1003, "name": "Outher"}
]İlk kullanıcının adını almak için {{users[0].name}}, ikinci kullanıcının kimliğini almak için ise {{users[1].id}} kullanın.
Bu, JSONPath benzeri semantiği takip eder—değişken adı kök ($) gibi davranır.
Betiklerde Değişkenleri Kullanma
Değişkenleri Pre Processors veya Post Processors'ın özel betiklerinde kullanabilirsiniz. Apidog, farklı türdeki değişkenlere esnek bir şekilde erişmenizi sağlayan eksiksiz bir betik API'si sunar.
// Proje düzeyinde genel bir değişkeni alın
pm.globals.get('variable_key');
// Ekip düzeyinde genel bir değişkeni alın
pm.globals.get('variable_key', 'TEAM');
// Bir ortam değişkenini alın
pm.environment.get('variable_key');
// Bir modül değişkenini alın
pm.moduleVariables.get('variable_key');
// Bir yerel değişkeni alın
pm.variables.get('variable_key');String olarak saklanan nesneler/diziler için önce ayrıştırın:
const userObj = JSON.parse(pm.environment.get('user'));
console.log(userObj.name);Test Verisi Değişkenleri ile Veri Odaklı Test Etme
Birden çok veri satırı içeren bir CSV veya JSON dosyası yükleyin. Yürütme sırasında, Apidog {{variableName}} değerini her satırdaki değerlerle değiştirir ve testi her satır için bir kez çalıştırır—birçok girdi ile sağlamlığı doğrulamak için mükemmeldir.
Dinamik Değer İfadeleri
Kendi değişkenlerinizin ötesinde, Apidog belirli kurallara göre rastgele veri üreten dinamik değerleri destekler.
Betiklerde, dinamik ifadeler içeren dizeleri await pm.variables.replaceInAsync() ile işleyebilirsiniz:
const template = "Merhaba, {{$person.fullName}}";
const result = await pm.variables.replaceInAsync(template);
console.log(result); // Rastgele oluşturulmuş bir isim çıktılar
Dinamik değerler, önceden bir veri kümesi hazırlamadan rastgele test verileri oluşturmak için mükemmeldir.
Özet
Değişkenler, Apidog'daki en güçlü özelliklerden biridir. Tekrarı azaltır, testleri esnek hale getirir ve projeler ile ortamlar arasında geçişi basitleştirir. İster ekipler arasında genel ayarları paylaşıyor, ister CSV verileriyle testleri yönetiyor, ister yerel olarak değerleri geçersiz kılıyor olun, değişkenler iş akışınızı verimli ve düzenli tutmanıza yardımcı olur. Değişken türlerini, önceliklerini ve ayarlama yollarını öğrenerek, API isteklerinizin tutarlı, sürdürülebilir ve gerçek dünya senaryolarına hazır kalmasını sağlayabilirsiniz.