Dinamik Değişkenler

Genel Bakış

Apinizer’da politika ayarları, bağlantı konfigürasyonları ve routing adresleri gibi birçok string alanda dinamik değişkenler kullanılabilir. Bu sayede sabit değerler yerine ortama, isteğe veya çalışma zamanına göre değişen değerler tanımlanabilir. İki tür dinamik değişken vardır:

Environment Variable — ${key}

Ortam değişkenleri, deploy anında çözümlenir. Geliştirme, test ve üretim gibi ortamlara göre farklı değerler alabilir.

Context Variable — #{key}

Bağlam değişkenleri, her istekte çözümlenir. İstek bilgileri, tarih/saat gibi sistem verileri veya script ile atanan özel değerler içerir.

İki Değişken Türü

Özellik	Environment Variable (`${key}`)	Context Variable (`#{key}`)
Format	`${variableName}`	`#{variableName}`
Çözümleme Zamanı	Deploy anında	Her istekte
Değer Kaynağı	Environment Variable yönetim ekranından tanımlanır	Sistem otomatik oluşturur veya script ile atanır
Ortam Bağımlılığı	Evet — dev, test, prod için farklı değer	Hayır — istek bazlı
Tanım Gereksinimi	Environment Variable ekranında tanım gerekir	Sistem değişkenleri: gerekmez. Global değişkenler: Custom Variable tanımı gerekir
Tipik Kullanım	Host adları, base URL’ler, port’lar, bağlantı bilgileri	Kullanıcı bilgileri, istek detayları, tarih/saat, hata bilgileri
Değişkenlik	Deploy sonrası sabittir	Her istekte farklı olabilir

Environment Variable (`${key}`)

Environment Variable’lar, farklı ortamlarda (geliştirme, test, üretim) farklı değerler kullanmanızı sağlar. Deploy anında çözümlenir ve çalışma zamanında sabit kalır. Örnek: ${api.hostname} → Geliştirmede localhost:8080, üretimde api.example.com

Environment Variable tanımlama ve yönetim hakkında detaylı bilgi için Environment Variable sayfasına bakabilirsiniz. CRUD işlemleri ve kullanım senaryoları için Environment Variable Yönetimi sayfasını inceleyebilirsiniz.

Context Variable (`#{key}`)

Context Variable’lar her istekte çözümlenir ve iki alt kategoriden oluşur: 1. Sistem Context Variable’ları — Otomatik oluşturulur, tanım gerektirmez:

#{context.request.httpMethod}, #{context.request.uri}, #{context.request.remoteAddress}
#{context.system.year}, #{context.system.dateTime}
#{context.message.correlationId}
#{context.apiProxy.name}, #{context.apiProxy.id}
#{context.credential.clientId}, #{context.credential.username}
#{error.defaultErrorCode}, #{error.defaultMessage}

2. Global Variable’lar — Script ile oluşturulur, Custom Variable tanımı gerekir:

#{userId}, #{tenantId}, #{customValue}
Script politikasında customVariableMap.put("key", "value") ile değer atanır

Variable tanımları hakkında detaylı bilgi için Değişkenler sayfasına bakabilirsiniz.

Karışık Kullanım

İki tür aynı anda kullanılabilir:

https://${api.hostname}/v1/users/#{userId}

${api.hostname} deploy anında çözümlenir (örn: api.example.com), #{userId} her istekte farklı değer alır.

Desteklenen Alanlar

Dinamik değişkenler, politika ve bağlantı ayarlarında neredeyse tüm string alanlarda kullanılabilir.

Politikalar

Politika	Desteklenen Alanlar	Değişken Türleri
REST API Call	URL, header, parametre, body	`${key}` ve `#{key}`
OIDC	Token endpoint, introspection endpoint, resource endpoint, form parametreleri	`${key}` ve `#{key}`
JOSE Validation / Implementation	Dynamic key HTTP endpoint	`${key}` ve `#{key}`
Authentication API	URL, header, parametre	`${key}` ve `#{key}`
Message Builder	Template, header, form alanları	`${key}` ve `#{key}`
Redaction	Key-value listesi	`${key}` ve `#{key}`
Diğer politikalar	Metin (string) giriş alanları	`${key}` ve `#{key}`

Script politikası bu tabloda yer almaz. Script politikasında #{key} placeholder mekanizması kullanılmaz çünkü değişkenlere zaten customVariableMap nesnesi ve request_httpMethod, dateTime_year gibi binding’ler üzerinden doğrudan erişim sağlanır. Detaylar için Script’te Kullanım Farkı bölümüne bakınız.

Bağlantılar

Bağlantı Türü	Desteklenen Alanlar
Database Connection	Host, port, kullanıcı adı, şifre, connection string
LDAP Connection	URL, base DN, kullanıcı adı, şifre
Email Connection	Host, port, kullanıcı adı

Diğer Alanlar

Alan	Desteklenen Türler
Routing Adresi	`${key}` ve `#{key}`
JSON Error Response Template	`#{key}` (hata değişkenleri dahil)
XML Error Response Template	`#{key}` (hata değişkenleri dahil)
Identity Provider (DB, LDAP, API)	`${key}` ve `#{key}`
IP Group	`${key}` ve `#{key}`
Credential	`${key}` ve `#{key}`

Bağlantı ayarlarında (Database, LDAP, Email) genellikle ${key} (Environment Variable) kullanılır çünkü bu değerler ortam bazlıdır ve deploy anında çözümlenmelidir. #{key} (Context Variable) ise istek zamanında çözümlenir ve daha çok politika ayarlarında ve routing adreslerinde kullanılır.

UI’da Değişken Seçimi

Politika ve bağlantı düzenleme ekranlarında, breadcrumb alanında “Değişken” butonu bulunur. Bu butona tıklandığında açılan menüden iki diyaloğa erişilebilir:

Environment Variable Diyaloğu

Menüden “Environment Variable” seçildiğinde açılan diyalog, tanımlanmış tüm ortam değişkenlerini listeler:

Global Değişkenler — Tüm ortamlarda geçerli olan değişkenler
Ortama Özel Değişkenler — Belirli ortamlar için tanımlanmış değişkenler

Değişkene tıklandığında ${variableName} formatında panoya kopyalanır ve ilgili alana yapıştırılabilir.

Context Variable Diyaloğu

Menüden “Context Variable” seçildiğinde açılan diyalog, kullanılabilir tüm bağlam değişkenlerini kategorize ederek listeler:

Error Variables — Hata bilgileri
Request Variables — İstek bilgileri
Message Variables — Mesaj bilgileri
API Variables — API Proxy bilgileri
Credential Variables — Kimlik bilgileri
DateTime Variables — Tarih/saat bilgileri

Değişkene tıklandığında #{variableName} formatında panoya kopyalanır.

Her iki diyalog da bağımsızdır. Aynı alanda hem ${key} hem #{key} kullanabilirsiniz.

Context Variable Referansı

Request (İstek)

Format	Açıklama	Örnek Değer
`#{context.request.httpMethod}`	HTTP metodu	`GET`, `POST`
`#{context.request.uri}`	İstek URI’si	`/api/users/123`
`#{context.request.contentType}`	İçerik tipi	`application/json`
`#{context.request.remoteAddress}`	İstemci IP adresi	`192.168.1.100`
`#{context.request.queryString}`	Query parametreleri	`?id=123`
`#{context.request.pathInfo}`	Path bilgisi	`/api/users`
`#{context.request.contextPath}`	Context path	`/apinizer`

DateTime (Tarih/Saat)

Format	Açıklama	Örnek Değer
`#{context.system.year}`	Yıl	`2026`
`#{context.system.month}`	Ay (1-12)	`2`
`#{context.system.dayOfMonth}`	Gün (1-31)	`4`
`#{context.system.dayOfWeek}`	Haftanın günü (1=Pazartesi, 7=Pazar)	`3`
`#{context.system.hour}`	Saat (0-23)	`14`
`#{context.system.minute}`	Dakika (0-59)	`30`
`#{context.system.second}`	Saniye (0-59)	`45`
`#{context.system.epochMillis}`	Unix timestamp (milisaniye)	`1707058245000`
`#{context.system.dateTime}`	Formatlanmış tarih/saat (UTC)	`2026-02-04T14:30:45.000Z`
`#{context.system.date}`	Formatlanmış tarih	`2026-02-04`
`#{context.system.time}`	Formatlanmış saat	`14:30:45`

Message (Mesaj)

Format	Açıklama	Örnek Değer
`#{context.message.correlationId}`	Benzersiz istek ID’si	`abc123-def456-ghi789`

API Proxy veya Proxy Group üzerinde tanımlanan özel message variable’lar da bu kategoride görüntülenir.

API

Format	Açıklama	Örnek Değer
`#{context.apiProxy.id}`	API Proxy ID’si	`api-proxy-123`
`#{context.apiProxy.name}`	API Proxy adı	`User Management API`

Credential (Kimlik)

Format	Açıklama	Örnek Değer
`#{context.credential.clientId}`	Kimlik doğrulanmış credential key/username	`my-app-key`
`#{context.credential.username}`	Credential kullanıcı adı	`admin`
`#{context.credential.email}`	Credential e-posta	`admin@example.com`
`#{context.credential.fullName}`	Credential tam adı	`Ahmet Yılmaz`

Error (Hata)

Format	Açıklama	Örnek Değer
`#{error.customizedErrorCode}`	Özelleştirilmiş hata kodu	`CUSTOM_001`
`#{error.customizedHttpCode}`	Özelleştirilmiş HTTP kodu	`400`
`#{error.customizedMessage}`	Özelleştirilmiş mesaj	`Lütfen tekrar deneyin`
`#{error.defaultErrorCode}`	Varsayılan hata kodu	`DEFAULT_001`
`#{error.defaultMessage}`	Varsayılan mesaj	`Bir hata oluştu`
`#{error.defaultHttpCode}`	Varsayılan HTTP kodu	`500`

Script’te Kullanım Farkı

Context variable’lar script politikası içinde farklı formatta kullanılır. Runtime’da nokta (.) ile ayrılan format, script’te alt çizgi (_) ile yazılır:

Runtime Format	Script Format
`#{context.request.httpMethod}`	`request_httpMethod`
`#{context.system.year}`	`dateTime_year`
`#{context.message.correlationId}`	`message_correlationId`
`#{context.apiProxy.name}`	`apiProxy_name`
`#{error.defaultErrorCode}`	`error_defaultErrorCode`

// Script içinde context variable kullanımı
String method = request_httpMethod
String year = dateTime_year
String correlationId = message_correlationId

Global Variable Kullanımı

Global variable’lar, Custom Variable tanımı ile oluşturulan ve script ile değer atanan değişkenlerdir. Politikalar arasında veri aktarımı için kullanılır.

Variable Tanımı Oluşturun

Project > Variables bölümünden Custom Variable tipinde yeni bir tanım oluşturun.

Script ile Değer Atayın

Script politikası içinde customVariableMap.put("variableName", "value") ile değer atayın.

Değişkeni Kullanın

#{variableName} formatında diğer politika ve ayarlarda kullanın.

Script Örneği:

// Request body'den kullanıcı bilgisi çıkarma
if (bodyTextFC != null && !bodyTextFC.isEmpty()) {
    def jsonBody = new groovy.json.JsonSlurper().parseText(bodyTextFC)
    if (jsonBody.userId) {
        customVariableMap.put("userId", jsonBody.userId.toString())
    }
}

// Header'dan değer alma
String token = headerMapFC.get("X-Custom-Token")
if (token != null) {
    customVariableMap.put("customToken", token)
}

Global variable’lar script politikası çalıştıktan sonra kullanılabilir. Değişkeni kullanan politika, değer atayan script politikasından sonra çalışmalıdır (policy sırası önemlidir).

Kullanım Örnekleri

Hata Yanıt Şablonu

{
  "error": {
    "code": "#{error.defaultErrorCode}",
    "message": "#{error.defaultMessage}",
    "requestId": "#{context.message.correlationId}",
    "timestamp": "#{context.system.epochMillis}"
  }
}

Dinamik Routing

https://${api.hostname}/v1/#{tenantId}/users/#{context.request.pathInfo}

${api.hostname} deploy anında, #{tenantId} ve #{context.request.pathInfo} her istekte çözümlenir.

Response Header Ekleme

X-Request-ID: #{context.message.correlationId}
X-API-Name: #{context.apiProxy.name}
X-Processed-At: #{context.system.dateTime}

Davranış Kuralları

Bulunamayan #{key} değerleri boş string ("") ile değiştirilir; hata fırlatılmaz, uyarı log’u yazılır
Bulunamayan ${key} değerleri çözümlenemez ve olduğu gibi kalır
Script politikasında custom variable map’e doğrudan erişim olduğu için #{...} placeholder mekanizması kullanılmaz
Variable isimleri büyük/küçük harf duyarsızdır

Sonraki Adımlar

Environment Variable

Ortam değişkenlerini detaylı öğrenin

Değişkenler

Variable tanımlarını öğrenin

Script Politikası

Script ile değişken kullanımı

Environment Variable Yönetimi

Environment Variable CRUD işlemleri

Başlangıç

Apinizer'ı Anlamak

Genel Bakış

Environment Variable — ${key}

Context Variable — #{key}

İki Değişken Türü

Environment Variable (`${key}`)

Context Variable (`#{key}`)

Karışık Kullanım

Desteklenen Alanlar

Politikalar

Bağlantılar

Diğer Alanlar

UI’da Değişken Seçimi

Environment Variable Diyaloğu

Context Variable Diyaloğu

Context Variable Referansı

Request (İstek)

DateTime (Tarih/Saat)

Message (Mesaj)

API

Credential (Kimlik)

Error (Hata)

Script’te Kullanım Farkı

Global Variable Kullanımı

Kullanım Örnekleri

Hata Yanıt Şablonu

Dinamik Routing

Response Header Ekleme

Davranış Kuralları

Sonraki Adımlar

Environment Variable

Değişkenler

Script Politikası

Environment Variable Yönetimi

Başlangıç

Apinizer'ı Anlamak

​Genel Bakış

Environment Variable — ${key}

Context Variable — #{key}

​İki Değişken Türü

​Environment Variable (${key})

​Context Variable (#{key})

​Karışık Kullanım

​Desteklenen Alanlar

​Politikalar

​Bağlantılar

​Diğer Alanlar

​UI’da Değişken Seçimi

​Environment Variable Diyaloğu

​Context Variable Diyaloğu

​Context Variable Referansı

​Request (İstek)

​DateTime (Tarih/Saat)

​Message (Mesaj)

​API

​Credential (Kimlik)

​Error (Hata)

​Script’te Kullanım Farkı

​Global Variable Kullanımı

​Kullanım Örnekleri

​Hata Yanıt Şablonu

​Dinamik Routing

​Response Header Ekleme

​Davranış Kuralları

​Sonraki Adımlar

Environment Variable

Değişkenler

Script Politikası

Environment Variable Yönetimi

Genel Bakış

İki Değişken Türü

Environment Variable (`${key}`)

Context Variable (`#{key}`)

Karışık Kullanım

Desteklenen Alanlar

Politikalar

Bağlantılar

Diğer Alanlar

UI’da Değişken Seçimi

Environment Variable Diyaloğu

Context Variable Diyaloğu

Context Variable Referansı

Request (İstek)

DateTime (Tarih/Saat)

Message (Mesaj)

API

Credential (Kimlik)

Error (Hata)

Script’te Kullanım Farkı

Global Variable Kullanımı

Kullanım Örnekleri

Hata Yanıt Şablonu

Dinamik Routing

Response Header Ekleme

Davranış Kuralları

Sonraki Adımlar