Ana içeriğe geç

Temel Kavramlar

Bu dört tasarım kafanızda oturduğunda, sonrasındaki her protokol ve senaryo kolaydır:

  1. Üç varlıklı model: Grup / Ortam / İstek birbirine nasıl bağlanır
  2. Ortam Pre-URL tasarımı: istekler neden yalnızca göreli yolları saklar
  3. Gönderim birleştirme hattı: tek bir Gönder, yapılandırmayı nasıl gerçek isteğe dönüştürür
  4. Değişken sistemi: {{variable}} nereden çözülür ve üç değişken katmanı

Üç Varlıklı Model​

Ortam neden her isteğe değil, gruba bağlanır? Grup genellikle "tek dağıtım hedefi altında bir modülün tüm API'lerini" temsil eder. Grup düzeyinde bağlama, ortam değiştirmenin tüm grubu tek seferde taşıdığı anlamına gelir — istek istek düzenleme yok. Tek bir istek farklı bir ortama ihtiyaç duyuyorsa, onu o ortama bağlı bir gruba koymanız yeterlidir.


Ortam Pre-URL Tasarımı​

Bu en önemli — ve en çok yanlış anlaşılan — tasarımdır.

İstekler göreli yolları saklar; ortamlar temel adresleri saklar​

Geleneksel araçlarda her istek tam URL'yi saklar (https://api.example.com/v1/users); test ortamına geçmek alan adlarının toplu değiştirilmesi demektir. Bu araç bunu tersine çevirir:

Şema, protokolü ve TLS'i belirler (kritik!)​

Pre-URL'ler protokol başına saklanır, ancak bir girişin gerçekte hangi protokole hizmet ettiğini URL'nin başındaki şema belirler. Şema hem "hangi protokol"ü hem de "şifreli mi (TLS)"yi ifade eder:

ProtokolAçık şemaŞifreli şema
HTTPhttp://https://
WebSocketws://wss://
TCPtcp://tcps://
UDPudp://—
gRPCgrpc://grpcs://
MQTTmqtt://mqtts://

⚠️ Sık yapılan hata: WebSocket temel adresi ws:// / wss:// olarak yazılmalıdır. https:// yazarsanız HTTP olarak ele alınır ve WebSocket isteği temel adres eksikliğinden başarısız olur. Protokol satırı ile şemayı tutarlı tutun.


Gönderim Birleştirme Hattı​

"Gönder"e dokunmak doğrudan bir soket açmaz. Hat, "istek + grubun ortamı + değişkenleri" adım adım gerçek bir isteğe dönüştürür ve ağ çağrısının öncesine ve sonrasına bir eylem zinciri yerleştirir:

Önemli noktalar:

  • Eylem zincirleri yalnızca "script çalıştırma" açıkken çalışır. Uygulamada Gönder'e dokunmak bunları varsayılan olarak çalıştırır; otomatik / MCP gönderimleri açıkça etkinleştirilmelidir. Script'ler kapalıyken gönderim öncesi enjekte edilen token'lar ya da şifreleme hiç gerçekleşmez — recipes içindeki "token yok → 401" negatif kontrolünün davranışı tam olarak bu yüzden böyledir.
  • Gönderim öncesi script'ler çıkmak üzere olan isteği yeniden yazar; yanıt sonrası script'ler gelen yanıtı yeniden yazar. İkisi de çalışma zamanı değişkenlerini okuyabilir ve yazabilir.

Değişken Sistemi​

Farklı kapsamlara sahip üç tür "değişken" vardır. Bunları karıştırmak en sık yapılan acemi tuzağıdır.

{{name}} gerçekte neyi çözebilir?​

Nerede yazıldıOrtam değişkenleriÇalışma zamanı değişkenleriTipik kullanım
{{name}} (URL / params / headers / body içinde)✅❌Ortam yapılandırmasına referans, dinamik doldurma
Script'lerin içinde değişken okuma✅✅Login token'larını istekler arasında taşıma vb.

Anımsatıcı: {{}} yalnızca "yapılandırma tipi" değişkenleri görür; script'ler üç katmanı da okuyabilir. Çalışma zamanı değişkenleri "çalışma zamanı tahtası"dır — üzerine yalnızca script'ler yazabilir, {{}} oraya asla bakmaz.

{{authToken}} neden login'de kaydedilen token'ı okuyamıyor? Çünkü login script'i onu çalışma zamanı katmanına kaydetmiştir; {{}} bu katmanı ayrıştırmaz. Doğru yaklaşım, onu okuyup header'ı enjekte eden bir gönderim öncesi script'tir (bkz. recipes, senaryo 1).

Dinamik değişkenler {{$xxx}}​

{{}} içinde ayrıca her değerlendirmede taze üretilen, URL / params / headers / body içinde doğrudan kullanılabilen bir dizi yerleşik dinamik değişken vardır:

DeğişkenÜrettiği
{{$timestamp}} / {{$timestampMs}}Saniye / milisaniye cinsinden Unix zaman damgası
{{$isoTimestamp}}ISO8601 UTC
{{$uuid}} / {{$guid}}UUID v4
{{$randomInt}} / {{$randomInt min,max}}Rastgele tam sayı (varsayılan 0..1000)
{{$randomBoolean}} {{$randomFullName}} {{$randomEmail}} {{$randomPhoneNumber}} {{$randomIpv4}} {{$randomIpv6}} {{$randomUrl}} {{$randomColor}} {{$randomHexadecimal}} {{$randomAlphaNumeric}} {{$randomCity}} {{$randomCountry}} {{$randomDateRecent}} {{$randomPrice}} {{$randomWord}} {{$randomLorem}} {{$randomCompanyName}} vb.Çeşitli rastgele örnek veriler

Örnek: GET /echo?ts={{$timestamp}}&u={{$uuid}} — uygulamada her gönderim ts/u değerlerini taze, gerçek değerlerle değiştirir.


Özet​

  • İstekler yol parçalarını saklar; ortamlar protokol başına temel adresleri Pre-URL ile sağlar; şema protokol + TLS'i belirler.
  • Gönderim bir birleştirme hattıdır: URL birleştirme → interpolasyon → aktarım ayarları → gönderim öncesi zincir → ağ → yanıt sonrası zincir.
  • Değişkenler üç katmandadır: {{}} yapılandırma tipi değişkenleri okur, script'ler üçünü de okur; token'ları {{}} ile değil script'lerle taşıyın.

Sıradaki: scripting →