> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.
# REST API Proxy Oluşturma
> RESTful API'lerinizi Apinizer platformu üzerinden yönetebilir ve güvenli bir şekilde expose edebilirsiniz. OpenAPI/Swagger spesifikasyon dosyasından REST API Proxy oluşturabilir, SOAP Web servislerinizi REST olarak açabilir, URL veya dosya yükleyebilir, routing yapılandırması yapabilir ve JSON formatında mesaj işleme gerçekleştirebilirsiniz
REST API Proxy, JSON formatında mesaj işleme yapar. Request ve response mesajları JSON formatındadır.
GET, POST, PUT, DELETE, PATCH gibi standart HTTP metodlarını destekler.
OpenAPI 2.0 (Swagger) ve OpenAPI 3.0 spesifikasyonlarını destekler.
Routing, politikalar ve ayarlar esnek bir şekilde yapılandırılabilir.
## REST API Proxy Oluşturma Yöntemleri
REST API Proxy oluşturmak için birkaç yöntem mevcuttur:
En yaygın yöntem, OpenAPI (Swagger) spesifikasyon dosyasından import etmektir. Bu yöntem, API'nizin tüm endpoint'lerini, parametrelerini ve şemalarını otomatik olarak içe aktarır.
OpenAPI dosyası olmadan da manuel olarak REST API Proxy oluşturabilirsiniz. Bu durumda endpoint'leri ve şemaları manuel olarak tanımlamanız gerekir.
Mevcut bir REST API Proxy'yi kopyalayarak yeni bir proxy oluşturabilirsiniz. Bu yöntem, benzer API'ler için zaman kazandırır.
SOAP protokolü ile geliştirilmiş bir Web Servisin REST olarak açılması talebi özellikle, var olan servislerin yeni geliştirilen mobil uygulamalar ya da JavaScript tabanlı Web uygulamaları tarafından kullanılması gibi durumlarda sıklıkla ortaya çıkmaktadır. Apinizer, SOAP Web servislerin REST olarak açılmasını ve bunun için gerekli bütün dönüşümlerin konfigürasyonla yapılabilmesini sağlar.
## OpenAPI/Swagger Dosyasından Import
Sol taraftaki ana menüde **Geliştirme → API Proxy'ler (Development → API Proxies)** ögesi seçilir. Açılan arayüzde sağ üstteki **+Add API Proxy** butonuna tıklanır ve **REST API** seçeneği seçilir.
OpenAPI dosyasını yüklemek için üç yöntem mevcuttur:
**URL Gir** bağlantısına tıklanır. OpenAPI/Swagger dosyasının URL'si girilir (örneğin: `https://petstore.swagger.io/v2/swagger.json`) ve **Parse** butonuna tıklanır. Dosya parse edilir ve API bilgileri görüntülenir.
**URL Erişimi** URL'den yükleme yaparken, Apinizer'in bu URL'ye erişebilmesi gerekir. Eğer URL internal bir adres ise, Apinizer'in bu adrese erişim izni olduğundan emin olun.
**Kimlik Doğrulama ve SSL** Spec URL'si kimlik doğrulama gerektiriyorsa, **Spec Authorization Kullan** seçeneğini etkinleştirerek özel header'lar veya **Basic Auth** (kullanıcı adı/şifre) bilgilerini girebilirsiniz. **SSL / Sertifika Ayarları** panelinde **Bağlantı Zaman Aşımı**, **SSL/TLS Ayarlarını Özelleştir**, **SSL Doğrulamayı Atla** ve **Sunucu Sertifikası Doğrulaması** (Sistem Varsayılanı, TrustStore veya PEM) ile HTTPS erişimini yapılandırabilirsiniz. Detay için [API Proxy Oluşturma](/tr/develop/api-proxy-olusturma/api-proxy-olusturma) sayfasına bakınız.
**Dosya Yükle (Upload File)** butonuna tıklanır. Bilgisayarınızdan OpenAPI/Swagger dosyası seçilir (JSON veya YAML formatında). Dosya otomatik olarak parse edilir ve API bilgileri görüntülenir.
**Metin Olarak Yapıştır (Paste as Text)** seçeneği seçilir. OpenAPI/Swagger içeriği metin alanına yapıştırılır ve **Parse** butonuna tıklanır. İçerik parse edilir ve API bilgileri görüntülenir.
Parse işlemi tamamlandıktan sonra, aşağıdaki bilgiler görüntülenir:
API'nin adı (OpenAPI dosyasından alınır)
API versiyonu
API'nin base URL'i
Tüm endpoint'ler ve HTTP metodları
Request ve response şemaları
Client Route, API Proxy'nin dış dünyaya açılan endpoint'idir. İstemciler bu endpoint üzerinden API'ye erişir.
**Örnek:**
```
Relative Path: /petstoreProxy
```
Bu durumda API Proxy'ye şu şekilde erişilir:
```
https://{apinizer-gateway}/petstoreProxy/pets
```
Upstream Target, backend REST API'nizin adresidir. API Proxy, istekleri bu adrese yönlendirir.
Tüm istekler tek bir backend adresine yönlendirilir.
**Örnek:**
```
https://api.example.com/v1
```
OpenAPI dosyasındaki `servers` veya `host` bilgisinden otomatik olarak alınır.
**Örnek:**
```
https://petstore.swagger.io/v2
```
Tüm bilgiler kontrol edilir. **Relative Path** alanı doldurulur (zorunlu). **Upstream Target** bilgisi kontrol edilir veya düzenlenir. Sağ üstteki **Kaydet** butonuna tıklanır.
API Proxy başarıyla oluşturuldu!
## Desteklenen OpenAPI Versiyonları
Apinizer, aşağıdaki OpenAPI versiyonlarını destekler:
* **OpenAPI 2.0 (Swagger 2.0)**: Tam destek
* **OpenAPI 3.0**: Tam destek
* **OpenAPI 3.1**: Tam destek
### OpenAPI 2.0 Özellikleri
* `swagger` alanı: `"2.0"` değeri
* `host`, `basePath`, `schemes` alanları
* `paths` ve `definitions` yapısı
* `parameters` ve `responses` tanımları
### OpenAPI 3.0/3.1 Özellikleri
* `openapi` alanı: `"3.0.0"` veya `"3.1.0"` değeri
* `servers` array'i
* `paths` ve `components` yapısı
* `requestBody` ve `responses` tanımları
* `securitySchemes` ve `security` tanımları
## Import Sonrası Yapılandırma
API Proxy oluşturulduktan sonra, aşağıdaki yapılandırmalar yapılabilir:
HTTP Routing, endpoint'lerin nasıl yönlendirileceğini belirler.
API Proxy'ye güvenlik, doğrulama, dönüştürme gibi politikalar eklenebilir.
API Proxy test edilebilir.
API Proxy ortam(lar)a deploy edilebilir.
## Yaygın Senaryolar
Bir public API'yi (örneğin, Petstore API) proxy etmek için:
Public API'nin OpenAPI dosyasının URL'si kullanılır.
Relative Path belirlenir (örneğin: `/petstoreProxy`).
Upstream Target olarak public API'nin base URL'i kullanılır.
API Proxy kaydedilir ve deploy edilir.
Internal bir REST API'yi dış dünyaya expose etmek için:
Internal API'nin OpenAPI dosyası yüklenir.
Relative Path belirlenir.
Upstream Target olarak internal API'nin adresi kullanılır.
Authentication, Authorization, Rate Limiting gibi güvenlik politikaları eklenir.
API Proxy kaydedilir ve deploy edilir.
Farklı versiyonlar için ayrı API Proxy'ler oluşturmak için:
Her versiyon için ayrı OpenAPI dosyası kullanılır.
Farklı Relative Path'ler kullanılır (örneğin: `/api/v1`, `/api/v2`).
Her versiyon için ayrı politikalar tanımlanır.
Versiyonlar arasında geçiş stratejisi belirlenir.
## En İyi Uygulamalar
OpenAPI dosyanızın geçerli ve güncel olduğundan emin olun. Geçersiz dosyalar import sırasında hata verebilir.
Relative Path'ler için tutarlı bir isimlendirme kuralı kullanın. Örneğin: `/{servis-adı}/{versiyon}`
Backend adreslerini environment variable olarak tanımlayın. Bu, farklı ortamlar için esneklik sağlar.
API Proxy oluşturduktan sonra mutlaka güvenlik politikaları ekleyin. Varsayılan olarak API'ler güvenli değildir.
## Sorun Giderme
**Sorun:** OpenAPI dosyası import edilemiyor.
**Çözüm:**
* OpenAPI dosyasının geçerli JSON veya YAML formatında olduğundan emin olun.
* OpenAPI versiyonunun desteklendiğinden emin olun.
* URL erişilebilirliğini kontrol edin.
* Dosya boyutunun limit içinde olduğundan emin olun.
**Sorun:** Import sonrası endpoint'ler görünmüyor.
**Çözüm:**
* OpenAPI dosyasında `paths` alanının doğru tanımlandığından emin olun.
* Endpoint'lerin `paths` altında doğru şekilde tanımlandığını kontrol edin.
**Sorun:** İstekler backend'e yönlendirilmiyor.
**Çözüm:**
* Upstream Target adresinin doğru olduğundan emin olun.
* Backend API'nin erişilebilir olduğunu kontrol edin.
* HTTP Routing yapılandırmasını kontrol edin.
## SOAP Web Servisinden REST API Proxy Oluşturma
SOAP protokolü ile geliştirilmiş bir Web Servisin REST olarak açılması talebi özellikle, var olan servislerin yeni geliştirilen mobil uygulamalar ya da JavaScript tabanlı Web uygulamaları tarafından kullanılması gibi durumlarda sıklıkla ortaya çıkmaktadır. Var olan servisin REST ile yeniden yazılması ya da metotlarını taklit eden yeni bir REST API geliştirilmesi seçenekleri zaman ve maliyet açısından etkin çözümler değildir.
Apinizer, SOAP Web servislerin REST olarak açılmasını ve bunun için gerekli bütün dönüşümlerin konfigürasyonla yapılabilmesini sağlar.
### SOAP Web Servisten REST Tipinde API Proxy Oluşturma
Yeni API Proxy oluşturulurken **WSDL** tipi için **URL Girme (Enter URL)** ya da **Dosya Yükle (Upload File)** seçeneklerinden uygun olan seçilir. Bu örnekte URL Girme seçeneği kullanılmıştır.
URL girilip **Parse** tuşuna basıldıktan sonra gelen ekranda **Protokol Dönüşümü (Protocol Transformation)** bölümünde **REST to SOAP to REST** seçeneği işaretlenir. Diğer zorunlu bilgiler de doldurularak API Proxy oluşturulur.
### Metot Dönüşüm Ayarları
API Proxy oluşturulduktan sonra, istenirse metotların istek ve yanıt mesajları için REST - SOAP mesaj yapıları arasında nasıl dönüşüm yapılacağı özelleştirilebilir. Bunun için API Proxy'nin **Geliştirme (Development)** sekmesine gidilir.
Sol taraftaki metot listesinde **Hepsi (All)** seçiliyken, orta bölümde üstte istek ve altta yanıt mesajlarının dönüşüm ayarlarını açan simgeler görünür.
Örneğin istek mesajlarına ait olan simgeye tıklandığında aşağıdaki protokol dönüşüm arayüzü açılır. Bu arayüzde **İstek Mesajı Seçenekleri (Request Options)** ve **Yanıt Mesajı Seçenekleri (Response Options)** sekmeleri bulunmaktadır. Kullanıcının hangi simgeye tıkladığına bağlı olarak ilgili sekme açılır.
Bu arayüzde REST protokolüne uygun olarak gelen istek mesajının Backend API'ye gönderilmeden önce SOAP yapısına uygun hale nasıl getirileceğine ilişkin biçimlendirmeler yapılır. Sol taraftan mesaj yapısı güncellenecek olan metot seçilir. Sağ tarafta ise o metoda ilişkin dönüşüm ayarları yapılır.
### Dönüşüm Seçenekleri
Bir SOAP Servis istemcilere REST olarak açıldığı zaman istek ve yanıt mesajlarının dönüştürülmesi gerekir. İstemciden gelen JSON mesaj SOAP servise gönderilmeden önce XML mesajına, SOAP servisin döndürdüğü XML mesaj ise istemciye gönderilmeden önce JSON mesajına dönüştürülmelidir. Bu dönüşümün yapılabilmesi için çeşitli seçenekler bulunmaktadır:
İstek ve yanıt mesajlarında kullanılacak olan JSON mesajının sade ve kolay anlaşılabilir olması gereken durumlarda tercih edilir. Diğerlerine göre oldukça özelleştirilebilir. En çok tercih edilen yöntemdir.
İstek ve yanıt mesajlarında kullanılacak olan JSON mesajının XML Attribute değerlerini ve XML Namespace'lerini de içermesi isteniyorsa tercih edilir. Diğerlerine göre JSON formatı daha karışıktır. Gösterimindeki Namespace'lerden dolayı XML gösterime benzediğinden veri büyüklüğü artar.
Gelen JSON mesajının hangi formatta olduğundan bağımsız, SOAP Servise gönderilecek olan XML şablonunu oluşturmak mantığı üzerine çalışır. XML şablonundaki parametrelerin doldurulması için "istek/yanıt verisi düzenlemesi (request/response data manipulation)" kullanılır. Çoklu alt eleman desteği olmadığından, basit yapıdaki XML'lerin olduğu durumda kullanışlıdır. Özellikle JSON mesajı yerine istek başlığı (request header) veya parametresinden (request parameter) veri alınıp çalışılmak isteniyorsa tercih edilir.
### İstek Mesajları Dönüşüm Seçenekleri
Bu bölümde istek mesajlarının dönüşüm seçeneklerinin detayları anlatılmaktadır.
#### Jackson Dönüşümü Kullan (Use Jackson Transformation)
| Alan | Açıklama |
| --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **NULL değerleri görmezden gel** (Ignore fields with NULL) | İşaretlenirse, Backend API'ye gönderilecek XML mesajın içine, istekte gelen JSON mesajdaki NULL değerleri XML Element olarak eklenmez. |
| **Boş değerleri görmezden gel** (Ignore EMPTY fields) | İşaretlenirse, Backend API'ye gönderilecek XML mesajın içine, istekte gelen JSON mesajdaki boş değerler XML Element olarak eklenmez. |
| **NULL değerler için xsi:nil="true" kullan** (Use xsi:nil="true" for NULL values) | İşaretlenirse, Backend API'ye gönderilecek XML mesajın içine, istekte gelen JSON mesajdaki NULL değerleri için xsi:nil="true" niteliği kullanılır. Aksi taktirde XML mesajın içine ilgili değer için boş eleman eklenir. Değerinin aktifleştirilmesi, json mesajında null olarak gönderilen değerin xml'e dönüştürülürken xsi:nil="true" alanı eklenerek iletilmesini sağlar. |
| **Hedef XPath** (Target XPath) | Gelen JSON mesajı XML'e dönüştürüldükten sonra elde edilen XML'in, SOAP servisin beklediği XML mesajın içinde nereye koyulacağını belirtir. |
| **Alt Elemanları Değiştir** (Replace Children) | Seçenek işaretlenirse, Target XPath'in çıktı öğesinin alt öğeleri silinerek JSON'dan dönüştürülen kısım bunların yerine eklenir. Aksi takdirde eleman tamamen değiştirilir. |
| **Dizi olan elemanlar** (Paths for Arrays within message) | JSON mesajın içinde hangi bölümlerin array olarak yorumlanması gerektiğini belirtir. Her bir Path, Hedef XPath'in seviyesinden (Hedef XPath verilmemişse en üst seviyeden) başlayarak ve seviyeler arasına # işareti koyularak yazılır. Örnek: "envelope#body#abc" ifadesi, "envelope" içindeki, "body"'nin içindeki "abc" elemanının array olarak işleme alınacağını belirtir.
**Array İçinde Array Olduğu Zaman:** Array içinde array olması durumunda ve bazı objeler bazen array bazen tekil şekilde geliyorsa, en dıştaki Array'in pathinden başlanarak yazılır ve alttaki objeye inerken array olan ifadelerden sonra #\* ifadesi eklenmesi gerekir. Örneğin abc elementi array ve içinde def elementi array olarak yer alıyorsa "envelope#body#abc, envelope#body#abc#\*#def" sırasıyla yazılmalıdır. |
| **İstek Verisi Düzenlemesi** (Request Data Manipulation) | Orijinal isteğin herhangi bir bölümü dönüştürülmüş isteğin belirtilen bir bölümüne aktarılabilir. Kaynak Değer/Değişken, orijinal istek mesajının hangi bölümünün aktarılacağını, Hedef Değer/Değişken ise Kaynak Değer/Değişken ile belirtilen bölümün dönüştürülmüş mesaj içinde nereye koyulacağını belirtir. |
| **Örnek Mesaj Göster** (Show Sample Message) | Ayarlara göre oluşan İstek Mesajı görüntülenebilir. |
**Dönüştürülmüş Mesaj Örneği:**
| API Proxy'nin İstemciden Beklediği JSON İstek Mesajı | Backend API/Servisin beklediği XML İstek Mesajı |
| ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `{ "Add": { "intB": "?", "intA": "?" } }` | ` ? ? ` |
#### JsonML Dönüşümü Kullan (Use JsonML Transformation)
| Alan | Açıklama |
| -------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **JSON Nesnesi kullan** (Use JSON Object) | XML Elemanlarını JSON Nesneleri (JSON Objects) olarak dönüştürür. |
| **JSON Dizisi kullan** (Use JSON Array) | XML Elemanlarını JSON Dizisi (JSON Array) olarak dönüştürür. |
| **İstek Verisi Düzenlemesi** (Request Data Manipulation) | Orijinal isteğin herhangi bir bölümü dönüştürülmüş isteğin belirtilen bir bölümüne aktarılabilir. Kaynak Değer/Değişken, orijinal istek mesajının hangi bölümünün aktarılacağını, Hedef Değer/Değişken ise Kaynak Değer/Değişken ile belirtilen bölümün dönüştürülmüş mesaj içinde nereye koyulacağını belirtir. |
| **Örnek Mesaj Göster** (Show Sample Message) | Ayarlara göre oluşan İstek Mesajı görüntülenebilir. |
**Dönüştürülmüş Mesaj Örneği:**
| Dönüşüm Tipi | API Proxy'nin İstemciden Beklediği JSON İstek Mesajı | Backend API/Servisin beklediği XML İstek Mesajı |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| JSON Object | `{ "soap:Envelope": { "xmlns:tem": "http://tempuri.org/", "soap:Header": "", "xmlns:soap": "http://www.w3.org/2003/05/soap-envelope", "soap:Body": { "tem:Add": { "tem:intA": "?", "tem:intB": "?" } } } }` | ` ? ? ` |
| JSON Array | `[ "soap:Envelope", { "xmlns:tem": "http://tempuri.org/", "xmlns:soap": "http://www.w3.org/2003/05/soap-envelope" }, [ "soap:Header" ], [ "soap:Body", [ "tem:Add", [ "tem:intA", "?" ], [ "tem:intB", "?" ] ] ] ]` | ` ? ? ` |
#### Şablon Mesajını Kullan (Use Template Message)
| Alan | Açıklama |
| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Şablon Message** (Template Message) | Backend API/Servisin beklediği XML istek mesajı şablonu |
| **İstek Veri Düzenlemesi** (Request Data Manipulation) | Orijinal isteğin herhangi bir bölümü dönüştürülmüş isteğin belirtilen bir bölümüne aktarılabilir. Kaynak Değer/Değişken, orijinal istek mesajının hangi bölümünün aktarılacağını, Hedef Değer/Değişken ise Kaynak Değer/Değişken ile belirtilen bölümün dönüştürülmüş mesaj içinde nereye koyulacağını belirtir. |
### Yanıt Mesajları Dönüşüm Seçenekleri
Bu bölümde yanıt mesajlarının dönüşüm seçeneklerinin detayları anlatılmaktadır.
#### Jackson Dönüşümü Kullan (Use Jackson Transformation)
| Alan | Açıklama |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **NULL değerleri görmezden gel** (Ignore fields with NULL) | Seçili ise, Backend API'den gelen XML mesajdaki, NULL alanlar JSON mesaja eklenmez. |
| **Boş değerleri görmezden gel** (Ignore EMPTY fields) | Seçili ise, Backend API'den gelen XML mesajdaki, NULL alanlar JSON mesaja boş değer olarak eklenmez. |
| **Numerik değerleri String olarak yaz** (Write Numbers as Strings) | Seçili ise numerik değerler JSON mesaja string olarak yazılır. |
| **NULL değerler için xsi:nil="true" kullan** (Use xsi:nil="true" for NULL values) | XML mesajda xsi:nil="true" niteliği ile gelen verilerin json'a dönüştürülürken null olarak iletilmesini sağlar. |
| **Kaynak XPath** (Source XPath) | XML olarak dönen yanıt mesajının JSON'a dönüştürülecek olan kısmının XPath'ini girilir. |
| **Elemanı Çöz** (Unwrap Element) | İşaretlenirse, Kaynak XPath ile verilen elemanın içini (çocuklarını), işaretlenmezse elemanın kendisini (içindekilerle/çocuklarıyla beraber) dönüştürür. |
| **Dizi olan elemanlar** (Paths for Arrays within message) | JSON mesajın içinde hangi bölümlerin array olarak yorumlanması gerektiğini belirtir. Her bir Path, Hedef XPath'in seviyesinden (Hedef XPath verilmemişse en üst seviyeden) başlayarak ve seviyeler arasına # işareti koyularak yazılır. Örnek: "envelope#body#abc" ifadesi, "envelope" içindeki, "body"'nin içindeki "abc" elemanının array olarak işleme alınacağını belirtir.
**Array İçinde Array Olduğu Zaman:** Array içinde array olması durumunda ve bazı objeler bazen array bazen tekil şekilde geliyorsa, en dıştaki Array'in pathinden başlanarak yazılır ve alttaki objeye inerken array olan ifadelerden sonra #\* ifadesi eklenmesi gerekir. Örneğin abc elementi array ve içinde def elementi array olarak yer alıyorsa "envelope#body#abc, envelope#body#abc#\*#def" sırasıyla yazılmalıdır. |
| **Başarı Durumunda Yanıt Verisi Düzenlemesi** (Response Data Manipulation on Success) | Orijinal yanıtın herhangi bir bölümü dönüştürülmüş yanıtın belirtilen bir bölümüne aktarılabilir. Kaynak Değer/Değişken, orijinal yanıt mesajının hangi bölümünün aktarılacağını, Hedef Değer/Değişken ise Kaynak Değer/Değişken ile belirtilen bölümün dönüştürülmüş mesaj içinde nereye koyulacağını belirtir. Tanımlanan işlemler yalnızca Backend API/Servisin başarılı yanıt döndürmesi durumunda gerçekleştirilir. |
| **Örnek Mesaj Göster** (Show Sample Message) | Ayarlara göre oluşan Yanıt Mesajı görüntülenebilir. |
**Dönüştürülmüş Mesaj Örneği:**
| Backend API/Servisin döndürdüğü XML Yanıt Mesajı | API Proxy'nin İstemciye Döndürdüğü JSON Yanıt Mesajı |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| ` ? ` | `{ "AddResponse" : { "AddResult" : "?" } }` |
#### JsonML Dönüşümü kullan (Use JsonML Transformation)
| Alan | Açıklama |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **JSON Nesnesi kullan** (Use JSON Object) | XML Elemanlarını JSON Nesneleri (JSON Objects) olarak dönüştürür. |
| **JSON Dizisi kullan** (Use JSON Array) | XML Elemanlarını JSON Dizisi (JSON Array) olarak dönüştürür. |
| **Başarı Durumunda Yanıt Verisi Düzenlemesi** (Response Data Manipulation on Success) | Orijinal yanıtın herhangi bir bölümü dönüştürülmüş yanıtın belirtilen bir bölümüne aktarılabilir. Kaynak Değer/Değişken, orijinal yanıt mesajının hangi bölümünün aktarılacağını, Hedef Değer/Değişken ise Kaynak Değer/Değişken ile belirtilen bölümün dönüştürülmüş mesaj içinde nereye koyulacağını belirtir. Tanımlanan işlemler yalnızca Backend API/Servisin başarılı yanıt döndürmesi durumunda gerçekleştirilir. |
| **Örnek Mesaj Göster** (Show Sample Message) | Ayarlara göre oluşan Yanıt Mesajı görüntülenebilir. |
**Dönüştürülmüş Mesaj Örneği:**
| Dönüşüm Tipi | Backend API/Servisin döndürdüğü XML Yanıt Mesajı | API Proxy'nin İstemciye Döndürdüğü JSON Yanıt Mesajı |
| ------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| JSON Object | ` ? ` | `{ "soap:Envelope" : { "xmlns:xsd" : "http://www.w3.org/2001/XMLSchema", "xmlns:soap" : "http://www.w3.org/2003/05/soap-envelope", "xmlns:xsi" : "http://www.w3.org/2001/XMLSchema-instance", "soap:Body" : { "AddResponse" : { "xmlns" : "http://tempuri.org/", "AddResult" : "?" } } } }` |
| JSON Array | ` ? ` | `[ "soap:Envelope", { "xmlns:xsd": "http://www.w3.org/2001/XMLSchema", "xmlns:soap": "http://www.w3.org/2003/05/soap-envelope", "xmlns:xsi": "http://www.w3.org/2001/XMLSchema-instance" }, [ "soap:Body", [ "AddResponse", { "xmlns": "http://tempuri.org/" }, [ "AddResult", "3" ] ] ] ]` |
#### Şablon Mesajını Kullan (Use Template Message)
| Alan | Açıklama |
| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Şablon Message** (Template Message) | İstemciye döndürülecek JSON yanıt mesajı |
| **Başarı Durumunda Yanıt Verisi Düzenlemesi** (Response Data Manipulation on Success) | Orijinal yanıtın herhangi bir bölümü dönüştürülmüş yanıtın belirtilen bir bölümüne aktarılabilir. Kaynak Değer/Değişken, orijinal yanıt mesajının hangi bölümünün aktarılacağını, Hedef Değer/Değişken ise Kaynak Değer/Değişken ile belirtilen bölümün dönüştürülmüş mesaj içinde nereye koyulacağını belirtir. Tanımlanan işlemler yalnızca Backend API/Servisin başarılı yanıt döndürmesi durumunda gerçekleştirilir. |
## Sonraki Adımlar
HTTP Routing yapılandırmasını öğrenin
Politikalar eklemeyi öğrenin
API Proxy'yi test etmeyi öğrenin
Deployment yapmayı öğrenin