Günümüz dağıtık sistemlerinde mikroservisler, uygulamaların ölçeklenebilir, bağımsız ve hızlı geliştirilmesini sağlar. Ancak servisler arasındaki iletişim doğru tanımlanmazsa sürüm uyumsuzlukları, veri kaybı ve bakım zorluğu gibi problemler ortaya çıkar. Bu derste, HTTP tabanlı JSON sözleşmesiyle versiyonlu bir endpoint nasıl tasarlanır, Python ile basit bir servis nasıl oluşturulur ve PHP istemcisiyle nasıl etkileşime girilir, adım adım gösterilecektir.
Temeller
Mikroservis iletişimi üç temel bileşene dayanır:
- Protokol: HTTP/HTTPS en yaygın protokoldür; hafif, geniş destekli ve firewall dostudur.
- Veri formatı: JSON, dil bağımsızlığı ve okunabilirliği sayesinde tercih edilir.
- Sözleşme (contract): İstemci ve sunucu arasında paylaşılan bir API tanımıdır; genellikle OpenAPI/Swagger ile belgelenir.
Versiyonlu endpoint, sözleşmenin değişmesi durumunda geriye dönük uyumluluğu korur. Örneğin /api/v1/orders ve /api/v2/orders aynı kaynak için farklı veri modelleri sunabilir.
Adım Adım Uygulama
Bu bölümde, Flask kullanarak /api/v1/greeting adlı bir mikroservis oluşturacağız. Servis, bir name parametresi alır ve JSON olarak selam mesajı döner.
from flask import Flask, request, jsonify
app = Flask(__name__)
@app.route('/api/v1/greeting', methods=['GET'])
def greeting_v1():
name = request.args.get('name', 'Dünya')
return jsonify({
'version': 'v1',
'message': f'Merhaba, {name}!'
})
if __name__ == '__main__':
app.run(debug=True)
Bu kodu greeting_service.py dosyasına kaydedin, bir sanal ortam (python -m venv venv) oluşturup etkinleştirin ve pip install flask komutuyla Flask'ı kurun. Çalıştırdıktan sonra http://127.0.0.1:5000/api/v1/greeting?name=Ali adresine bir GET isteği gönderdiğinizde aşağıdaki JSON yanıtını alacaksınız:
{
"version": "v1",
"message": "Merhaba, Ali!"
}
Versiyon 2 için aynı endpoint'i /api/v2/greeting altında farklı bir veri modeliyle genişletebiliriz.
Örnek Kod
Aşağıda iki ayrı PHP örneği bulacaksınız. İlk örnek, bir PHP istemcisiyle mikroservise GET isteği gönderir. İkinci örnek ise Slim framework kullanarak basit bir PHP mikroservis oluşturur.
<?php
// php_client.php – Flask servisine GET isteği gönderir
$url = 'http://127.0.0.1:5000/api/v1/greeting?name=Ayşe';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($httpCode == 200) {
$data = json_decode($response, true);
echo "Versiyon: {$data['version']}, Mesaj: {$data['message']}\n";
} else {
echo "Hata: HTTP $httpCode\n";
}
?>
<?php
// php_service.php – Slim framework ile versiyonlu endpoint
require __DIR__ . '/vendor/autoload.php';
$app = new \Slim\App();
$app->get('/api/v1/greeting', function ($request, $response, $args) {
$params = $request->getQueryParams();
$name = $params['name'] ?? 'Dünya';
$payload = [
'version' => 'v1',
'message' => "Merhaba, $name!"
];
$response->getBody()->write(json_encode($payload));
return $response->withHeader('Content-Type', 'application/json');
});
$app->run();
?>
PHP örneklerini çalıştırmak için composer require slim/slim:"4.*" komutunu kullanın ve ardından php -S localhost:8080 php_service.php ile servisiniz dinlemeye başlasın.
Sık Karşılaşılan Hatalar
- Versiyon karışıklığı: Endpoint URL'inde versiyon numarasını tutarlı tutmazsanız eski istemciler yeni sözleşmeyi anlamaz.
- JSON kodlaması: Yanıtı
json_encodeyerine manuel string oluşturursanız karakter kaçış hataları ortaya çıkar. - CORS eksikliği: Tarayıcı tabanlı istemciler farklı origin'lerden çağrı yapıyorsa
Access-Control-Allow-Originbaşlığını eklemeyi unutmayın. - Hata yönetimi: 4xx/5xx durum kodlarını döndürüp gövdeye açıklama eklemezseniz istemci sorunları tanımlayamaz.
Özet ve Kontrol Listesi
Bu derste öğrendikleriniz:
- Mikroservislerde HTTP/JSON sözleşmesinin önemi.
- Versiyonlu endpoint tasarımı.
- Flask ile basit bir Python servisi.
- PHP cURL ile istemci ve Slim ile servis örnekleri.
Uygulama sonrası aşağıdaki kontrol listesini doldurun:
- Versiyon numarası URL içinde tutarlı mı?
- JSON yanıtı
Content-Type: application/jsonbaşlığıyla mı gönderiliyor? - Hata durumları için uygun HTTP durum kodları kullanıldı mı?
- PHP istemcisi ve servisi sorunsuz çalışıyor mu?
SSS
Soru 1: Versiyonlu endpoint yerine tek bir endpoint içinde Accept-Version başlığı kullanabilir miyim?
Cevap: Evet, header tabanlı sürümleme mümkündür ancak URL tabanlı sürümleme (ör. /v1/) daha okunaklı ve cache dostudur.
Soru 2: JSON yerine Protobuf gibi ikili formatlar kullanmak daha iyi mi?
Cevap: Protobuf performans avantajı sağlar, ancak ek şema yönetimi ve dil desteği gerektirir. Başlangıç seviyesinde JSON yeterlidir.
Soru 3: Mikroservisler arası iletişimde sadece HTTP yeterli mi?
Cevap: Çoğu senaryoda evet; yüksek performanslı düşük gecikmeli ihtiyaçlar için gRPC, RabbitMQ gibi mesaj kuyrukları tercih edilebilir.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.