API DESIGN: RESTFUL APIS EĞİTİMİ

RESTful API tasarımını sağlam temelle öğrenin

REST kısıtları, HTTP semantiği, URI ve veri modeli, sayfalama, önbellek, hata yanıtı ve OpenAPI ile RESTful API tasarımı

REST kısıtları, HTTP semantiği, URI ve veri modeli, sayfalama, önbellek, hata yanıtı ve OpenAPI ile RESTful API tasarımı. RESTful API tasarımının temelden uygulamaya yolu odağında uygulamalı laboratuvarlarla işlenir.

3 gün Temel Seviye Online / Yüz Yüze / Hibrit Sertifikalı

Eğitim Hakkında

RESTful API tasarımının temelden uygulamaya yolu

Eğitim RESTful API tasarımının ilkelerini örneklerle öğretir. Fielding kısıtları, Richardson olgunluk modeli, GET/POST/PUT/PATCH/DELETE semantiği, durum kodları, URI adlandırma, JSON veri modeli, sayfalama ve filtreleme, ETag ve Cache-Control, HATEOAS, problem+json hata biçimi, sürümleme, OpenAPI sözleşmesi ve OAuth 2.0 koruması Postman ile pekiştirilir.

Süre ve Format

3 Gün. Her gün dört modül; 1. gün REST İlkeleri ve HTTP; 2. gün Sorgu, Önbellek ve Hata; 3. gün Sürüm, Sözleşme ve Güvenlik.

Seviye

Temel Seviye — RESTful API tasarımının temelden uygulamaya yolu

Öğrenme Metodu

Her konu, gerçek bir API üzerinde istek göndererek ve tasarım kararlarını tartışarak işlenir; katılımcılar OpenAPI tanımı yazıp Postman ve curl ile sonuçlarını doğrular.

Neden Bu Eğitim?

📐Tasarım Kuralları

HTTP semantiği, URI ve model kararlarını standartlara dayandırarak tutarlı API'ler tasarlarsınız.

🔍Canlı İnceleme

Gerçek istek ve yanıtları curl ve Postman ile inceleyerek teoriyi hemen pratiğe dökersiniz.

📄Sözleşme Odaklılık

OpenAPI ile yazılan sözleşme sayesinde ekipler arası uyumu ve dokümantasyonu otomatikleştirirsiniz.

Anahtar Konular

rest apirestful apiapi tasarımıopenapiswaggerhttp metotlarıjsonapi geliştirmeapi design: restful apis
“REST, kurallar kitabı değil bir tasarım disiplinidir.”

Ön Koşullar

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

1
Programlama Temeli

Herhangi bir dilde temel programlama bilgisi ve JSON okuyabilme becerisi yeterlidir.

2
Web Bilgisi

Tarayıcı, URL ve HTTP'nin kabaca nasıl çalıştığına dair temel fikir faydalıdır.

3
Araçlar

Postman, curl ve bir metin editörü (VS Code) kurulu bir bilgisayar gerekir.

4
Merak

Örnek API'ler üzerinde deneme yapmaya açık olmak yeterli ön koşuldur.

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 REST Mimari İlkeleri konusunu çalıştırır, HTTP Metot ve Durum Kodu Semantiği ve URI Tasarımı ve Kaynak Modelleme ile ilerleyip REST API Veri Modelleri kararlarını gerekçelendirir.
Modül 1
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 2
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 3
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ı
Modül 4
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ı
Günün hedefiKatılımcı Sayfalama, Filtreleme ve Sıralama ve HTTP Önbellekleme konularını uygulayarak Hata Yönetimi ve Problem Details ile Hipermedya ve HATEOAS adımlarını aynı örnek üzerinde birleştirir.
Modül 1
Sayfalama, Filtreleme ve Sıralama
  • Offset / limit ile cursor (keyset) sayfalama arasındaki performans farkı
  • Link başlığı (RFC 8288) ve next / prev bağlantıları
  • Filtre sözdizimi: eşitlik, aralık, arama ve çoklu değer
  • sort=-createdAt gibi sıralama parametreleri ve güvenli alan beyaz listesi
  • Alan seçimi (fields) ve ilişkili kaynakları genişletme (expand / include)
  • Toplam kayıt sayısının maliyeti ve X-Total-Count alternatifleri
Modül 2
HTTP Önbellekleme
  • Cache-Control yönergeleri: max-age, s-maxage, no-store, no-cache, private, public
  • ETag ve If-None-Match ile koşullu GET, 304 Not Modified yanıtı
  • Last-Modified ve If-Modified-Since farkı
  • If-Match ile iyimser eşzamanlılık kontrolü ve 412 Precondition Failed
  • Vary başlığı ve CDN / ters vekil (Varnish, NGINX) önbelleği davranışı
  • Önbellek geçersizleştirme stratejileri ve stale-while-revalidate
Modül 3
Hata Yönetimi ve Problem Details
  • RFC 9457 / 7807 application/problem+json yapısı: type, title, status, detail, instance
  • Doğrulama hatalarında alan bazlı hata listesi biçimi
  • 4xx ile 5xx ayrımı: istemci hatası ile sunucu hatası sorumluluğu
  • Hata mesajlarında bilgi sızıntısını önleme (stack trace, SQL ifadesi)
  • İstek kimliği (correlation ID) ile hata yanıtlarının loglarla eşleştirilmesi
  • 429 Too Many Requests ve Retry-After ile istemci geri çekilme (backoff) yönlendirmesi
Modül 4
Hipermedya ve HATEOAS
  • HATEOAS fikri: yanıt içinde durum geçişlerini bağlantı olarak sunma
  • Spring HATEOAS veya benzeri araçlarla bağlantı üretimi
  • Link ilişki türleri (rel) ve IANA kayıtlı değerler
  • Hipermedya ile istemci-sunucu bağımlılığının azaltılması
  • URI şablonları (RFC 6570) ve eylem keşfi
  • HATEOAS'ın pratik maliyeti ve kullanıldığı gerçek örnekler
Günün hedefiKatılımcı gün sonunda Sürümleme ve API Evrimi konusunu çalıştırır, OpenAPI ile Sözleşme ve Dokümantasyon ve OAuth 2.0, JWT ve API Yetkilendirme ile ilerleyip Postman Arayüzü ve İlk İstekler kararlarını gerekçelendirir.
Modül 1
Sürümleme ve API Evrimi
  • Kırıcı (breaking) ve kırıcı olmayan değişikliklerin sınıflandırılması
  • URI, başlık (Accept vendor media type) ve sorgu parametresiyle sürümleme
  • Alan ekleme, alan kaldırma ve alan yeniden adlandırma stratejileri
  • Deprecation ve Sunset başlıkları (RFC 8594) ile emeklilik duyurusu
  • Tolerant reader ilkesi ve tüketici uyumluluğu
  • Sürümler arası kullanım izleme ve geçiş takvimi planlama
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
OAuth 2.0, JWT ve API Yetkilendirme
  • Authorization Code + PKCE, Client Credentials ve Refresh Token akışları
  • JWT yapısı: header, payload, imza; RS256 ve HS256 farkı
  • JWT zafiyetleri: alg=none, zayıf anahtar, süresi dolmuş token kabulü
  • Scope ve claim tabanlı yetkilendirme, RBAC ve ABAC
  • Token iptali, kısa ömürlü access token ve rotasyon
  • Keycloak ile yetkilendirme sunucusu kurulumu ve API entegrasyonu
Modül 4
Postman Arayüzü ve İlk İstekler
  • Workspace, collection, folder ve request hiyerarşisi
  • GET, POST, PUT, DELETE istekleri; params, headers, body (raw JSON, form-data, x-www-form-urlencoded)
  • Yanıt panelinde Body, Cookies, Headers, Test Results ve süre / boyut bilgisi
  • Authorization sekmesi: API Key, Bearer Token, Basic Auth, OAuth 2.0
  • Postman Console ile istek / yanıt ayrıntılarının hata ayıklaması
  • Collection'ı dışa aktarma, içe aktarma ve ekip workspace'inde paylaşma

Eğitim Kazanımları

Program sonunda katılımcılar:

✅
REST İlkeleri

REST kısıtlarını ve olgunluk modelini kullanarak bir API'nin tasarım kalitesini değerlendirebilirsiniz.

🧩
URI Tasarımı

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

🔧
Veri Modeli Tasarımı

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

📐
Önbellek Yönetimi

ETag ve Cache-Control ile API yanıtlarını önbelleğe alıp tutarlılığı koruyabilirsiniz.

🛡️
Hata Yönetimi

Tutarlı problem+json hata yanıtları üretip istemcilerin hatadan toparlanmasını kolaylaştırabilirsiniz.

🧪
API Evrimi

Kırıcı değişiklikleri yönetip API'nizi tüketicileri bozmadan geliştirebilirsiniz.

🚀
OpenAPI Sözleşmesi

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

📊
Postman Kullanımı

Postman'da koleksiyon oluşturup farklı kimlik doğrulama yöntemleriyle istek gönderebilirsiniz.

Kimler İçin Uygundur?

  • RESTful API tasarlamaya yeni başlayan yazılımcılar
  • analistler
  • mobil / web geliştiricileri için uygundur

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?
RESTful API tasarlamaya yeni başlayan yazılımcılar, analistler ve mobil / web geliştiricileri için uygundur.
Hangi dil ve çatı kullanılıyor?
Tasarım ilkeleri dilden bağımsızdır; uygulama örnekleri OpenAPI, Postman ve seçilen bir sunucu çatısı üzerinden gösterilir.
Hazır API mi kullanılacak, yoksa kendimiz mi yazacağız?
Her ikisi de; hazır genel API'lerle başlanır, ardından kendi örnek API'nizi tasarlayıp sözleşmesini yazarsınız.
Eğitim sonunda ne öğrenmiş olacağım?
Tutarlı bir REST API tasarlayıp OpenAPI ile belgeleyebilir, hata, sürümleme ve güvenlik konularında karar verebilirsiniz.
Sertifika veriliyor mu?
Evet, 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 d Digital Vizyon AKADEMİ KATILIM SERTİFİKASI Bu sertifika [Katılımcı Adı Soyadı] adlı katılımcının aşağıdaki eğitim programını başarıyla tamamladığını belgeler. API Design: RESTful APIs Eğitimi Sertifika Kodu DV-2026XX00 Tarih 27.10.2026 Yetkili İmza DV AKADEMİ

Eğitim Bilgileri

Süre3 gün
SeviyeTemel Seviye
FormatOnline / Yüz Yüze / Hibrit
Sertifika✓ Var
Hemen Bilgi Al
İlgili Eğitimler

Bu Eğitimle Birlikte Tercih Edilenler

API ve Mikroservis MimarisiREST API - siteler arası bilgi alışverişinde kullanılan bir desen Eğitimi
Yazılım Geliştirme Eğitimleri

REST API - siteler arası bilgi alışverişinde kullanılan bir desen Eğitimi

2 günTemelOnline / Yüz Yüze / Hibrit

REST ile siteler arası bilgi alışverişi: HTTP, SOAP karşılaştırması, JSON/XML, CORS ve güvenlik. 2 gün uygulamalı eğitim, DVA Katılım ve Başarı Sertifikası.

Detayları Gör →
API ve Mikroservis MimarisiREST API: Architecture & Databases Deployment Eğitimi
Yazılım Geliştirme Eğitimleri

REST API: Architecture & Databases Deployment Eğitimi

3 günOrtaOnline / Yüz Yüze / Hibrit

REST API mimarisi ve veritabanıyla dağıtım: tasarım, güvenlik, test, konteyner ve izleme. 3 gün uygulamalı eğitim, DVA Katılım ve Başarı Sertifikası.

Detayları Gör →
API ve Mikroservis MimarisiREST API: Exploring the Basic Features Eğitimi
Yazılım Geliştirme Eğitimleri

REST API: Exploring the Basic Features Eğitimi

2 günBaşlangıçOnline / Yüz Yüze / Hibrit

REST API temel özellikleri: HTTP, kaynaklar, CRUD, durum kodları ve JSON/XML formatları. 2 gün uygulamalı eğitim, DVA Katılım ve Başarı Sertifikası.

Detayları Gör →
API ve Mikroservis MimarisiREST API: Working with Methods & Formatters Eğitimi
Yazılım Geliştirme Eğitimleri

REST API: Working with Methods & Formatters Eğitimi

2 günTemelOnline / Yüz Yüze / Hibrit

REST API metotları ve formatter'ları: idempotency, PATCH, içerik pazarlığı, JSON/XML ve hipermedya. 2 gün uygulamalı eğitim, DVA Katılım ve Başarı Sertifikası.

Detayları Gör →
API ve Mikroservis MimarisiREST Assured API Testing: Getting Started with REST Assured Testing Eğitimi
Yazılım Geliştirme Eğitimleri

REST Assured API Testing: Getting Started with REST Assured Testing Eğitimi

2 günTemelOnline / Yüz Yüze / Hibrit

REST Assured ile API test otomasyonuna giriş: given/when/then, Hamcrest, JSON doğrulama ve raporlama. 2 gün uygulamalı eğitim, DVA Katılım ve Başarı Sertifikası

Detayları Gör →
+90 (501) 369 40 14 WhatsApp [email protected] LinkedIn