RIZEDIJITAL PLATFORM API · V1

Geliştirici Merkezi

RizeDijital'in seçilmiş kamuya açık şehir verilerini kendi web sitenize, mobil uygulamanıza veya sunucu servisinize güvenli ve sürümlü API üzerinden bağlayın. API v1 salt okunur çalışır ve mevcut RizeDijital web/native akışlarından bağımsızdır.

v1 API Key JSON Read-only 17 servis Üyelik gerekli
3 adımda entegrasyon

Hızlı Başlangıç

API'yi kullanmak için karmaşık bir SDK kurmanız gerekmez. RizeDijital üyeliğiniz, API anahtarınız ve standart HTTP GET istekleri yeterlidir.

Mobilde kaydır
01

API anahtarını oluştur

API Erişimim ekranında hesabınıza bağlı anahtarı oluşturun. Tam anahtar yalnız üretildiği anda bir kez gösterilir.

02

Anahtarı backend'de sakla

Anahtarı environment variable veya secret manager içinde tutun. Public JavaScript, Git deposu veya mobil binary içine açık metin gömmeyin.

03

İlk GET isteğini gönder

Authorization: Bearer başlığıyla bir servis çağırın ve dönen success / data / meta yapısını işleyin.

Temel adres: https://rizedijital.com/api/v1. Veri endpointleri API anahtarı ister; API kök endpointi servis keşfi için kullanılabilir.
entegrasyon akışı

API nasıl çalışır?

API v1 mevcut RizeDijital Core/Service katmanının üzerinde izole bir adaptör olarak çalışır. Web ve native uygulamanın mevcut davranışını değiştirmez.

Geliştirici hesabıNormal RizeDijital üyeliği kullanılır.
API anahtarıHesaba bağlı, hash saklamalı erişim anahtarı.
YetkilendirmeAnahtar, modül ve kota kontrolü yapılır.
RizeDijital CoreMevcut güvenilir veri kaynakları okunur.
JSON yanıtıSürümlü ve standart response döner.
Salt okunurv1 dışarıdan veri oluşturmaz, değiştirmez veya silmez.
Özel veri kapalıMesaj, ödeme, admin, özel üyelik ve kişisel sosyal veriler dışarı açılmaz.
Sürümlü sözleşme/api/v1 kontratı mevcut web sayfalarından bağımsız geliştirilir.
authentication

Kimlik doğrulama

Her veri isteğinde API anahtarınızı HTTP header ile gönderin. Önerilen yöntem Bearer Token'dır.

Önerilen: Bearer

Sunucu tarafı entegrasyonlarda standart ve okunabilir yöntem.

Authorization: Bearer rdv1_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Alternatif: X-API-Key

Özel header kullanmak isteyen servisler için eşdeğer yöntem.

X-API-Key: rdv1_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Query string anahtarı yalnız zorunlu durumlar içindir. ?api_key=... desteklenir ancak URL'ler proxy, analytics ve sunucu loglarına yazılabileceğinden önerilmez.
RizeDijital veritabanında tam API anahtarı tutulmaz. Üretimden sonra yalnız SHA-256 özeti, görünür ön ek/son dört karakter ve kullanım metrikleri saklanır.
çalışan başlangıç şablonları

Kod örnekleri

Aşağıdaki örnekler aynı hava durumu endpointini çağırır. Gerçek anahtarınızı kaynak koda yazmak yerine ortam değişkeninden okuyun.

Kodlar arasında swipe
curl --request GET \
  --url 'https://rizedijital.com/api/v1/hava-durumu?ilce=merkez' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer API_ANAHTARINIZ'
Tarayıcı tarafında fetch() teknik olarak CORS açıkken çalışabilir; ancak API anahtarının ziyaretçiye görünmesi nedeniyle üretimde anahtarlı çağrıları kendi backend/proxy katmanınızdan yapın.
rate limit & pagination

Kota ve sayfalama

Varsayılan limitler aşağıdadır. Yönetici belirli bir üyeye daha düşük veya daha yüksek özel limit tanımlayabilir.

Dakikalık limit60Bir API anahtarı için varsayılan istek sayısı
Günlük limit5000Takvim günü başına varsayılan toplam
Maks. sayfa boyutu50limit parametresinin üst sınırı
X-RateLimit-Limit-MinuteDakikalık toplam hakkınız
X-RateLimit-Remaining-Minuteİçinde bulunduğunuz dakika için kalan hak
X-RateLimit-Limit-DayGünlük toplam hakkınız
X-RateLimit-Remaining-DayBugün için kalan hak
Retry-After429 durumunda yeniden denemeden önce beklenmesi önerilen süre
Sayfalı servislerde page veya sayfa ile sayfayı, limit ile kayıt sayısını belirleyebilirsiniz. Yanıttaki meta.pagination toplam kayıt, toplam sayfa ve sonraki/önceki sayfa bilgisini döndürür.
api v1 katalog

Servis kataloğu

Yalnız dış sistemlerin tüketmesi mantıklı, kamuya açık veri grupları API'ye açılmıştır. Kartlarda görünen servisler yönetici tarafından şu anda etkin olanlardır.

Konumlar

Rize ilçe ve konum listesi.

GET
/api/v1/konumlar

Haberler

Yayındaki RizeDijital haberleri.

GET
/api/v1/haberler
/api/v1/haberler/{slug}
kategoripage / sayfalimit

Duyurular

Şehir ve kurum duyuruları.

GET
/api/v1/duyurular
/api/v1/duyurular/{slug}
qkategoriilcepage / sayfalimit

Etkinlikler

Şehir etkinlikleri ve takvim verisi.

GET
/api/v1/etkinlikler
/api/v1/etkinlikler/{slug}
qkategoriilcepage / sayfalimit

Hava Durumu

İlçe bazlı hava durumu.

GET
/api/v1/hava-durumu
ilce

Nöbetçi Eczaneler

Güncel nöbetçi eczane verisi.

GET
/api/v1/eczaneler
ilceq

Hastaneler

Aktif hastane, tıp merkezi ve acil servis bilgileri.

GET
/api/v1/hastaneler
ilceturacilq

Dolmuş Saatleri

Aktif ve doğrulanmış/işaretlenmiş dolmuş hatları.

GET
/api/v1/dolmuslar
ilceq

Taksi & Transfer

Aktif taksi durağı, transfer ve kamuya açık fiyat bilgileri.

GET
/api/v1/taksi-transfer
ilceturq

Otoparklar

Aktif otopark, kapasite, ücret ve konum bilgileri.

GET
/api/v1/otoparklar
ilceturq

Yol Durumu

Yerel cache üzerinden yol olayları ve trafik özeti.

GET
/api/v1/yol-durumu
ilce

Akaryakıt

Rize ilçe bazlı akaryakıt fiyatları.

GET
/api/v1/akaryakit
ilce

Çay Fiyatları

Güncel yaş çay/kuru çay ve alım noktası verisi.

GET
/api/v1/cay-fiyatlari
ilce

İşletmeler

Onaylı yerel işletme rehberi.

GET
/api/v1/isletmeler
/api/v1/isletmeler/{kimlik}
ilcekategoriqpage / sayfalimit

Videolar

Yayındaki video kataloğu.

GET
/api/v1/videolar
/api/v1/videolar/{slug}
turkategoriqsiralapage / sayfalimit

Galeri

Onaylı şehir fotoğraf galerisi.

GET
/api/v1/galeri
/api/v1/galeri/{slug}
kategorikaynakilceqsiralapage / sayfalimit

Yakınımda

Koordinata göre yakın şehir noktaları.

GET
/api/v1/yakinimda
latlngyaricapkategoriaciklimit
İlçe parametresi: çoğu konum bazlı serviste ilce=merkez gibi slug veya geçerli ilçe ID'si kullanılabilir. İlçe belirtilmezse ilgili servisin varsayılan davranışı uygulanır.
Yakınımda: lat ve lng zorunludur. yaricap, kategori, acik=1 ve limit ile sonuç kümesini daraltabilirsiniz.
response contract

Yanıt formatı

Tüm başarılı veri endpointleri aynı üst seviye sözleşmeyi kullanır: success, data ve meta.

Başarılı yanıt

data endpoint'e göre nesne veya liste olabilir. meta her zaman sürüm, request ID ve üretim zamanı taşır.

{
  "success": true,
  "data": { ... },
  "meta": {
    "version": "v1",
    "request_id": "rdapi_...",
    "generated_at": "2026-08-29T18:30:00+03:00"
  }
}

Sayfalı yanıt

Liste endpointlerinde meta.pagination eklenir. Böylece istemci URL tahmini yapmak zorunda kalmadan sayfa durumunu bilir.

"pagination": {
  "page": 1,
  "per_page": 25,
  "total": 142,
  "total_pages": 6,
  "has_next": true,
  "has_previous": false
}
X-API-VersionYanıtı üreten API sözleşme sürümü
X-Request-IdHata ayıklama ve destek taleplerinde kullanılabilecek benzersiz istek kimliği
Content-Type: application/json; charset=utf-8Tüm API v1 cevapları JSON olarak döner
error contract

Hata kodları

Hatalarda HTTP durum koduna ek olarak makine tarafından okunabilir error.code ve geliştiriciye açıklayıcı error.message alanı döner.

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "API istek limitiniz aşıldı."
  },
  "meta": {
    "version": "v1",
    "request_id": "rdapi_...",
    "generated_at": "..."
  }
}
HTTPKodAnlamıNe yapmalısınız?
401API_KEY_REQUIREDAPI anahtarı gönderilmedi.Bearer veya X-API-Key header ekleyin.
401INVALID_API_KEYAnahtar bulunamadı veya geçersiz.API Erişimim alanından anahtarı yenileyin.
403API_KEY_DISABLEDAnahtar yönetici tarafından pasife alınmış.Hesap/erişim durumunu kontrol edin.
404MODULE_DISABLEDİstenen servis API'de kapalı.Servis kataloğundaki aktif endpointleri kullanın.
404LOCATION_NOT_FOUNDİlçe/konum çözümlenemedi./api/v1/konumlar çıktısındaki slug veya ID'yi kullanın.
422INVALID_PARAMETERParametre desteklenmeyen bir değer taşıyor.Endpoint parametrelerini kontrol edin.
429RATE_LIMIT_EXCEEDEDDakikalık veya günlük kota aşıldı.Retry-After ve rate-limit header'larını izleyin.
503API_DISABLEDAPI v1 geçici olarak kapalı.Daha sonra tekrar deneyin.
503MAINTENANCERizeDijital bakım modunda.Retry/backoff stratejisi uygulayın.
production checklist

Güvenli kullanım

API anahtarı kullanıcı hesabınızı temsil eder. Entegrasyonu üretime almadan önce aşağıdaki kuralları uygulayın.

Anahtarı sunucuda tutunEnvironment variable, secret manager veya güvenli sunucu yapılandırması kullanın.
Git deposuna eklemeyin.env ve secret dosyalarını version control dışında bırakın.
Şüphede anahtarı yenileyinYeni anahtar üretildiğinde önceki aktif anahtar otomatik iptal edilir.
429 için backoff kullanınSabit döngüyle tekrar denemek yerine Retry-After bilgisini dikkate alın.
Request ID'yi loglayınDestek ve hata ayıklamada X-Request-Id değerini kendi logunuza ekleyin.
Özel veri beklemeyinAPI v1 kamu şehir verisi içindir; özel üye/admin verisi bilinçli olarak kapsam dışıdır.

Entegrasyona başlamak için hesabınızı bağlayın.

API anahtarı oluşturmak için RizeDijital üye hesabıyla giriş yapmanız gerekir.

API Erişimim
Ana Sayfa Yakınımda
İlanlar Hesap