API Development: REST & SOAP Web Services Eğitimi

Eğitim Hakkında

REST ve SOAP web servislerinin karşılaştırmalı uygulaması

Eğitim iki web servis dünyasını yan yana öğretir. REST kısıtları, HTTP semantiği ve URI tasarımı; SOAP zarfı, WSDL, XSD, JAX-WS ile servis geliştirme, WS-Security, JAX-RS ile REST uçları, JSON ve XML veri modelleri, OpenAPI ve WSDL sözleşmeleri ile hata yönetimi farkları, SoapUI ve Postman ile servis testi uygulamalı olarak üç günde işlenir.

Süre ve Format

3 Gün. Her gün dört modül; 1. gün API Kavramları ve REST Temeli; 2. gün SOAP, WSDL ve JAX-WS; 3. gün Veri Modelleri, Sözleşme ve Test.

Seviye

Orta Seviye — REST ve SOAP web servislerinin karşılaştırmalı uygulaması

Öğrenme Metodu

Katılımcılar WSDL dosyalarını okuyup servis üretir, SoapUI ve istemci kodu ile mesaj alışverişini adım adım izleyerek uygulamalı çalışır.

Neden Bu Eğitim?

📜Sözleşme Disiplini

WSDL ve XSD ile katı tipli servis sözleşmelerini okuyup üretmeyi öğrenirsiniz.

🏢Kurumsal Entegrasyon

Bankacılık, kamu ve ERP entegrasyonlarında yaygın SOAP servisleriyle çalışma yetkinliği kazanırsınız.

🔁REST ile Birlikte

SOAP servislerini REST cephesiyle birlikte sunmak ve modernleştirmek için pratik yollar görürsünüz.

Anahtar Konular

soapwsdlweb servisjax-wssoapuixmlws-securitysoap web servicesapi development: rest & soap web services

“İki dili de bilen, entegrasyonu kazanır.”

Ön Koşullar

Eğitimden verim almak için faydalı olacak bilgi ve ortam gereksinimleri

1

Java veya Benzeri Dil

Temel nesne yönelimli programlama ve sınıf/arayüz kavramlarına aşinalık beklenir.

2

XML Bilgisi

Eleman, öznitelik ve ad alanı gibi XML temel kavramları bilinmelidir.

3

Geliştirme Ortamı

JDK 17+, Maven ve bir IDE ile SoapUI kurulu bilgisayar gerekir.

4

HTTP Bilgisi

İstek ve yanıt başlıklarının temel yapısı hakkında fikir sahibi olmak faydalıdır.

Eğitim İçeriği

Programın gün gün akışı aşağıdadır. Bir güne tıklayarak o günün modüllerini ve içeriklerini görebilirsiniz.

Günün hedefiKatılımcı gün sonunda API Kavramı ve Web Servis Türleri konusunu çalıştırır, REST Mimari İlkeleri ve HTTP Metot ve Durum Kodu Semantiği ile ilerleyip URI Tasarımı ve Kaynak Modelleme kararlarını gerekçelendirir.

Modül 1

API Kavramı ve Web Servis Türleri

API nedir: kütüphane API'si, işletim sistemi API'si ve web API'si ayrımı
İstemci-sunucu modeli, istek / yanıt döngüsü ve HTTP mesaj yapısı (başlık, gövde, durum satırı)
Web servis türleri: REST, SOAP, GraphQL ve gRPC'nin kullanım alanları
Genel, ortak (partner) ve özel (private) API ayrımı ile iş modelleri
JSON ve XML veri biçimleri, Content-Type ve Accept başlıkları
Gerçek bir genel API'yi tarayıcı geliştirici araçları ve curl ile inceleme

Modül 2

REST Mimari İlkeleri

Fielding'in altı kısıtı: istemci-sunucu, durumsuzluk, önbellek, tek tip arayüz, katmanlı sistem, isteğe bağlı kod
Kaynak (resource) odaklı düşünme ve temsil (representation) kavramı
Richardson Olgunluk Modeli seviye 0-3
Tek tip arayüz: kaynak tanımlama, temsil üzerinden manipülasyon, öz-açıklayıcı mesaj
Durumsuzluk (stateless) ve oturum bilgisinin istemcide veya token'da taşınması
REST ile RPC tarzı API'lerin karşılaştırılması

Modül 3

HTTP Metot ve Durum Kodu Semantiği

GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS metotlarının amaçları
Güvenli (safe) ve idempotent metot kavramı, PUT ile POST farkı
PATCH için JSON Patch (RFC 6902) ve JSON Merge Patch (RFC 7396)
2xx, 3xx, 4xx, 5xx durum kodu aileleri; 201 + Location, 204, 202 kullanımı
400, 401, 403, 404, 405, 409, 415, 422, 429 kodlarının doğru ayrımı
Content negotiation: Accept, Accept-Language ve 406 / 415 yanıtları

Modül 4

URI Tasarımı ve Kaynak Modelleme

İsim tabanlı çoğul koleksiyon adları: /orders, /orders/{id}/items
İlişkili kaynaklar için iç içe yol ve sorgu parametresi tercihleri
Kaynak olmayan işlemler için eylem kaynakları (ör. /orders/{id}/cancellation)
Büyük/küçük harf, tire ve snake_case kuralları; sondaki eğik çizgi
Yol parametresi ile sorgu parametresi arasındaki ayrım ve filtre tasarımı
URI sürümleme ile başlık sürümlemenin kıyaslanması

Günün hedefiKatılımcı SOAP, WSDL ve XSD Temelleri ve JAX-WS ile SOAP Servis Geliştirme konularını uygulayarak WS-* Standartları ve SOAP Güvenliği ile REST ve SOAP Servislerinin Birlikte Geliştirilmesi adımlarını aynı örnek üzerinde birleştirir.

Modül 1

SOAP, WSDL ve XSD Temelleri

SOAP zarfı: Envelope, Header, Body ve Fault elemanları
WSDL 1.1 yapısı: types, message, portType, binding, service
Document/literal ve RPC/encoded biçimleri ile WS-I Basic Profile
XSD ile karmaşık tip, kısıt (restriction) ve ad alanı (namespace) yönetimi
SOAP Action başlığı, HTTP üzerinden taşıma ve SOAP 1.1 ile 1.2 farkları
REST ile SOAP'un kıyaslanması: sözleşme katılığı, araç desteği, kurumsal kullanım

Modül 2

JAX-WS ile SOAP Servis Geliştirme

@WebService, @WebMethod, @WebParam ve @WebResult açıklamalarıyla servis tanımı
Endpoint.publish ile hızlı yayın, Tomcat / WildFly üzerinde dağıtım
Contract-first: wsimport ile WSDL'den, wsgen ile koddan artifact üretimi
JAXB ile Java-XML eşleme: @XmlRootElement, @XmlElement, XmlAdapter
SOAPHandler ve LogicalHandler ile mesaj yakalama / kayıt
İstemci proxy'si, Service ve Dispatch API ile servis çağrısı

Modül 3

WS-* Standartları ve SOAP Güvenliği

WS-Security: UsernameToken, X.509 imza ve XML şifreleme
WS-Addressing ile asenkron mesaj yönlendirme
MTOM / XOP ile ikili (binary) ek taşıma
WS-ReliableMessaging ve mesaj teslimi garantisi mantığı
SOAP Fault tasarımı ve hata kodlarının istemciye aktarılması
XML saldırıları: XXE, XML bomb ve parser sertleştirme

Modül 4

REST ve SOAP Servislerinin Birlikte Geliştirilmesi

JAX-RS ile @Path, @GET, @POST ve @Produces açıklamaları
Jersey ve CXF ile aynı projede hem REST hem SOAP uç noktası yayınlama
JSON ve XML içerik anlaşması (content negotiation) örnekleri
Aynı iş mantığını iki arayüze açan servis katmanı tasarımı
SOAP ve REST için hata yönetimi farkları (Fault ile problem+json)
Eski SOAP sistemlerinin REST cephesiyle (facade) modernizasyonu

Günün hedefiKatılımcı gün sonunda REST API Veri Modelleri konusunu çalıştırır, OpenAPI ile Sözleşme ve Dokümantasyon ve SoapUI ile Servis Testine Giriş ile ilerleyip Postman Test Betikleri ve Doğrulamalar kararlarını gerekçelendirir.

Modül 1

REST API Veri Modelleri

JSON veri tipleri, null / eksik alan ayrımı ve tarih için ISO 8601 / RFC 3339
JSON Schema ile doğrulama: required, enum, pattern, oneOf
DTO ile alan modeli ayrımı ve verinin aşırı açığa çıkmasının önlenmesi
HAL, JSON:API ve Siren gibi hipermedya biçimlerinin karşılaştırılması
Para birimi, zaman dilimi ve çok dilli metin için model kararları
XML, Protocol Buffers ve MessagePack temsillerinin JSON ile kıyaslanması

Modül 2

OpenAPI ile Sözleşme ve Dokümantasyon

OpenAPI 3.x yapısı: paths, components, schemas, parameters, responses
$ref ile yeniden kullanım, allOf / oneOf ve discriminator
securitySchemes: apiKey, http bearer, oauth2 ve openIdConnect
Swagger Editor ve Stoplight ile tasarım, Spectral ile kural tabanlı lint
openapi-generator ile sunucu iskeleti ve istemci SDK'sı üretimi
Örnek (example) alanları ve Redoc ile geliştirici dokümanı yayınlama

Modül 3

SoapUI ile Servis Testine Giriş

WSDL ve OpenAPI içe aktarma, otomatik istek şablonu üretimi
Test suite, test case ve test step hiyerarşisi
SOAP request, REST request, Properties ve Delay test adımları
Property Transfer ile adımlar arası veri aktarımı
Çevre (endpoint) yönetimi ve çoklu ortam testi
SoapUI açık kaynak ile ReadyAPI özelliklerinin karşılaştırılması

Modül 4

Postman Test Betikleri ve Doğrulamalar

pm.test ve pm.expect (Chai) ile durum kodu, süre ve başlık doğrulamaları
pm.response.json() ile gövde alanı doğrulama ve JSON Schema (tv4/Ajv) kontrolü
Pre-request script ile dinamik veri, zaman damgası ve imza üretimi
Collection, folder ve request seviyesinde script kapsamı ve çalışma sırası
postman.setNextRequest ve pm.execution.setNextRequest ile akış kontrolü
Test sonuçlarında başarısızlık analizi ve flaky testlerin ayıklanması

Eğitim Kazanımları

Program sonunda katılımcılar:

✅

API Temelleri

API türlerini ayırt edip gerçek bir web API'sinin istek ve yanıtını okuyabilirsiniz.

🧩

HTTP Semantiği

HTTP metotlarını ve durum kodlarını doğru semantikle kullanan uçlar tasarlayabilirsiniz.

🔧

URI Tasarımı

Tutarlı, okunabilir ve genişletilebilir URI şemaları tasarlayabilirsiniz.

📐

JAX-WS Geliştirme

JAX-WS ile contract-first ve code-first SOAP servisleri geliştirip tüketebilirsiniz.

🛡️

SOAP Güvenliği

WS-Security ve XML saldırılarına karşı önlemlerle SOAP servislerini güvenli hale getirebilirsiniz.

🧪

Veri Modeli Tasarımı

JSON Schema ile doğrulanan, sürdürülebilir REST veri modelleri tasarlayabilirsiniz.

🚀

OpenAPI Sözleşmesi

OpenAPI ile makine okunur API sözleşmesi yazıp kod ve doküman üretebilirsiniz.

📊

Postman Testleri

pm.test ile durum kodu, başlık ve gövde doğrulayan otomatik testler yazabilirsiniz.

Kimler İçin Uygundur?

Kurumsal entegrasyon geliştiricileri
Java yazılımcıları
eski SOAP sistemlerini modernleştirecek ekipler içindir

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Kurumsal entegrasyon geliştiricileri, Java yazılımcıları ve eski SOAP sistemlerini modernleştirecek ekipler içindir.

SOAP hâlâ kullanılıyor mu?

Evet; finans, kamu, telekom ve ERP entegrasyonlarında yaygın olarak SOAP servisleri bulunur ve bakımı yapılması gerekir.

REST bilgisi gerekli mi?

Zorunlu değil; ancak karşılaştırma için REST'in temel ilkeleri eğitimde kısaca hatırlatılır.

Hangi araçlar kullanılıyor?

SoapUI, bir Java IDE'si, Maven ve uygulama sunucusu ile servisler hem yazılır hem test edilir.

Sertifika veriliyor mu?

Tamamlayan katılımcılara Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir.

Sertifikalandırma

Bu eğitim Digital Vizyon Akademi Başarı Sertifikası ile tamamlanır.

Eğitim başında “Ön Test”, bitiminde “Son Test” uygulanarak gelişim ölçümlenir. Değerlendirme formunu dolduran katılımcılar sertifikalarını alır. Sertifikanızın geçerliliğini Sertifika Sorgulama sayfasından doğrulayabilirsiniz.

Örnek Sertifika

API DEVELOPMENT: REST & SOAP WEB SERVICES EĞİTİMİ

Eğitim Hakkında

Neden Bu Eğitim?

Anahtar Konular

Ön Koşullar

Eğitim İçeriği

API Kavramı ve Web Servis Türleri

REST Mimari İlkeleri

HTTP Metot ve Durum Kodu Semantiği

URI Tasarımı ve Kaynak Modelleme

SOAP, WSDL ve XSD Temelleri

JAX-WS ile SOAP Servis Geliştirme

WS-* Standartları ve SOAP Güvenliği

REST ve SOAP Servislerinin Birlikte Geliştirilmesi

REST API Veri Modelleri

OpenAPI ile Sözleşme ve Dokümantasyon

SoapUI ile Servis Testine Giriş

Postman Test Betikleri ve Doğrulamalar

Eğitim Kazanımları

Kimler İçin Uygundur?

Sıkça Sorulan Sorular

Sertifikalandırma

Eğitim Bilgileri

Bu Eğitimle Birlikte Tercih Edilenler

API Entegrasyonları ile Make: Gelişmiş Otomasyon Eğitimi

API Error Handling: Best Practices Eğitimi

API Gateways Eğitimi

API Management Eğitimi

API Management: Strategy & Monitoring Eğitimi