REST API, kaynakları URL’lerle temsil eden ve işlemleri HTTP yöntemleriyle ifade eden yaygın bir web API yaklaşımıdır. Örneğin GET /contacts kişileri listeler, POST /contacts yeni kişi oluşturur.
Temel yapı taşları
- Endpoint: İşlem yapılacak kaynak adresi
- HTTP metodu: Okuma, oluşturma, güncelleme veya silme niyeti
- Header: Yetki, içerik türü ve istek bağlamı
- Body: Gönderilen JSON verisi
- Status code: İşlemin sonucunu özetleyen sayı
Sık kullanılan durum kodları
200 ve 201 başarılı işlemleri; 400 hatalı isteği; 401 kimlik doğrulama eksikliğini; 403 yetki yetersizliğini; 404 bulunamayan kaynağı; 429 hız limitini; 500 ise sunucu tarafındaki beklenmeyen hatayı anlatır.
REST her proje için şart mı?
Hayır. Gerçek zamanlı akışlarda WebSocket, esnek sorgularda GraphQL veya yüksek performanslı servis iletişiminde gRPC uygun olabilir. REST, geniş araç desteği ve anlaşılır yapısı nedeniyle çoğu web entegrasyonunda iyi bir başlangıçtır.
REST API Nedir hakkında sorular
REST API ile HTTP API aynı mı?
Her REST API HTTP kullanır; ancak HTTP kullanan her API REST ilkelerine uymak zorunda değildir.
PUT ve PATCH farkı nedir?
PUT çoğunlukla kaynağın tamamını değiştirmeyi, PATCH yalnızca belirtilen alanları güncellemeyi ifade eder.
Platform özellikleri ve sağlayıcı koşulları değişebileceği için canlı kurulum öncesinde bağlantılı resmî belgeleri kontrol edin.