API Dokümantasyonu

Başlangıç

ShentaAPI, RESTful mimari ile çalışan modern bir API servisidir. Tüm istekler HTTPS üzerinden yapılmalıdır ve JSON formatında yanıt döner.

Base URL

https://api.shentaweb.com/api/v1/

İstek Formatı

Tüm API istekleri GET metoduyla yapılır. Yanıtlar JSON formatındadır.

Kimlik Doğrulama

Tüm API isteklerinde kimlik doğrulama zorunludur. API anahtarınızı iki şekilde gönderebilirsiniz:

Query Parameter ile

GET /api/v1/kripto.php?api_key=YOUR_API_KEY

Header ile (Önerilen)

Authorization: Bearer YOUR_API_KEY

Hata Kodları

Hata Yanıt Formatı

{
    "success": false,
    "error": {
        "code": 401,
        "message": "Geçersiz API anahtarı"
    }
}

Anahtar Durum Sorgulama

API anahtarınızın güncel durumunu, kalan süresini, sorgu limitlerini ve erişebildiğiniz servisleri öğrenir. Bu endpoint sorgu limitinize dahil edilmez ve log kaydı tutulmaz.

Endpoint

GET /api/v1/durum.php

Parametreler

* ?api_key= parametresi yerine Authorization: Bearer header'ı da kabul edilir.

Örnek İstek

GET /api/v1/durum.php?api_key=YOUR_API_KEY

curl -X GET "https://api.shentaweb.com/api/v1/durum.php" \
     -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

{
    "success": true,
    "data": {
        "api_key":       "sk_live_a*************9f3b",
        "aktif":         true,
        "durum":         "aktif",
        "paket":         "Pro Plan",
        "baslangic":     "2025-01-01 10:00:00",
        "bitis":         "2026-01-01 10:00:00",
        "kalan_gun":     231,
        "limit": {
            "toplam":    5000,
            "kullanilan": 312,
            "kalan":     4688,
            "yuzde":     6.2,
            "periyot":   "aylik",
            "override":  null
        },
        "servisler": [
            { "ad": "Döviz Kurları",    "slug": "doviz",  "aciklama": "TL bazlı döviz kuru sorgulama" },
            { "ad": "Kripto Paralar",   "slug": "kripto", "aciklama": "Güncel kripto para fiyatları" },
            { "ad": "Nöbetçi Eczane",  "slug": "eczane", "aciklama": "İl bazında nöbetçi eczane listesi" }
        ],
        "servis_sayisi": 3
    }
}

Yanıt Alanları

Döviz Kurları

Güncel döviz kurlarını TL bazında getirir. Veriler saatlik olarak güncellenir.

Endpoint

GET /api/v1/doviz.php

Parametreler

Örnek İstek

GET /api/v1/doviz.php?api_key=YOUR_API_KEY&kod=USD

Örnek Yanıt

{
    "success": true,
    "data": {
        "guncelleme": "2024-01-15 14:30:00",
        "baz": "TRY",
        "adet": 1,
        "veriler": [
            {
                "kod": "USD",
                "ad": "Amerikan Doları",
                "alis": 30.25,
                "satis": 30.85,
                "kur": 30.55
            }
        ]
    }
}

Kripto Paralar

Güncel kripto para fiyatlarını ve piyasa verilerini getirir. CoinGecko API'den alınan veriler saatlik olarak güncellenir.

Endpoint

GET /api/v1/kripto.php

Parametreler

Örnek İstek

GET /api/v1/kripto.php?api_key=YOUR_API_KEY&limit=10

curl -X GET "https://api.shentaweb.com/api/v1/kripto.php?limit=10" \
     -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

{
    "success": true,
    "data": {
        "guncelleme": "2024-01-15 14:30:00",
        "adet": 10,
        "veriler": [
            {
                "id": "bitcoin",
                "sembol": "BTC",
                "ad": "Bitcoin",
                "logo": "https://...",
                "fiyat_usd": 42150.25,
                "piyasa_degeri": 825000000000,
                "hacim_24s": 28500000000,
                "degisim_24s": 2.45,
                "en_yuksek_24s": 42500,
                "en_dusuk_24s": 41200,
                "sira": 1
            }
        ]
    }
}

Futbol Puan Durumu

Avrupa'nın önde gelen futbol liglerinin güncel puan durumlarını getirir. Veriler düzenli olarak güncellenir.

Endpoint

GET /api/v1/futbol.php

Parametreler

Mevcut Ligler

Örnek İstek

GET /api/v1/futbol.php?api_key=YOUR_API_KEY&lig=superlig

curl -X GET "https://api.shentaweb.com/api/v1/futbol.php?lig=premierleague" \
     -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt

{
    "success": true,
    "data": {
        "lig": "Süper Lig",
        "lig_kodu": "superlig",
        "ulke": "Türkiye",
        "guncelleme": "2024-01-15 14:30:00",
        "takim_sayisi": 19,
        "puan_durumu": [
            {
                "sira": "1",
                "takim": "Galatasaray",
                "logo": "https://...",
                "mac": "20",
                "galibiyet": "16",
                "beraberlik": "3",
                "maglubiyet": "1",
                "goller": "52:15",
                "averaj": "+37",
                "puan": "51"
            }
        ]
    }
}

Nöbetçi Eczane

Türkiye'deki 81 ilin günlük nöbetçi eczane bilgilerini getirir. Veriler her gün saat 01:00'de e-Devlet (TITCK) üzerinden otomatik olarak güncellenir.

Endpoint

GET /api/v1/eczane.php

Parametreler

Geçerli Şehir Slug Değerleri

Tüm 81 il desteklenmektedir. Slug değerleri şehir adının Türkçe karaktersiz, küçük harf ve boşuksuz halidir.

Örnek İstekler

# Tüm İstanbul nöbetçi eczaneleri
GET /api/v1/eczane.php?api_key=YOUR_API_KEY&sehir=istanbul

# İlçeye göre gruplu sonuç
GET /api/v1/eczane.php?api_key=YOUR_API_KEY&sehir=istanbul&format=ilceli

# Belirli bir ilçe
GET /api/v1/eczane.php?api_key=YOUR_API_KEY&sehir=istanbul&ilce=Kadıköy

# cURL örneği
curl -X GET "https://api.shentaweb.com/api/v1/eczane.php?sehir=ankara" \
     -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt — Düz Liste

{
    "success": true,
    "data": {
        "tarih": "01/01/2025",
        "sehir": "İstanbul",
        "sehir_slug": "istanbul",
        "plaka": 34,
        "adet": 45,
        "guncelleme": "2025-01-01 01:12:34",
        "eczaneler": [
            {
                "name": "ÖRNEK ECZANE",
                "district": "Kadıköy",
                "phone": "0216 123 45 67",
                "address": "Moda Cad. No:1 Kadıköy/İstanbul",
                "nobet_baslangic": "09:00 01/01/2025",
                "nobet_bitis": "09:00 02/01/2025",
                "durum": "Onaylanmış"
            }
        ]
    }
}

Örnek Yanıt — İlçeli Format (format=ilceli)

{
    "success": true,
    "data": {
        "tarih": "01/01/2025",
        "sehir": "İstanbul",
        "sehir_slug": "istanbul",
        "plaka": 34,
        "adet": 45,
        "guncelleme": "2025-01-01 01:12:34",
        "ilceler": {
            "Kadıköy": [
                {
                    "name": "ÖRNEK ECZANE",
                    "district": "Kadıköy",
                    "phone": "0216 123 45 67",
                    "address": "Moda Cad. No:1 Kadıköy/İstanbul",
                    "nobet_baslangic": "09:00 01/01/2025",
                    "nobet_bitis": "09:00 02/01/2025",
                    "durum": "Onaylanmış"
                }
            ],
            "Beşiktaş": [ "..." ]
        }
    }
}

Veri Henüz Hazır Değilse

{
    "success": false,
    "error": {
        "code": 503,
        "message": "Eczane verileri henüz hazır değil. Cron henüz çalışmamış olabilir."
    }
}

Eczane Nesnesi Alanları

Önemli Notlar

• Veriler günlük olarak güncellenir; gerçek zamanlı sorgu yapılmaz.
• Nöbetçi eczane listesi e-Devlet sisteminden otomatik çekildiği için e-Devlet'in bakımda olduğu durumlarda o gün verisi eksik kalabilir.
• sehir parametresi slug formatında gönderilmelidir (Türkçe karakter kullanmayın). Örnek: istanbul, izmir, canakkale.
• Tüm şehir verisi aynı anda çekilmek istenirse sehir parametresini boş bırakın. Bu durumda yanıt boyutu büyük olabilir.
• nobet_baslangic, nobet_bitis ve durum alanları e-Devlet TITCK sisteminin sağladığı ek bilgilerdir; e-Devlet güncellemesi sonrası eklenmiştir.

Hava Durumu

Türkiye'deki 81 il için güncel hava durumu bilgisi getirir.

Endpoint

GET /api/v1/hava.php

Parametreler

Örnek İstek

GET /api/v1/hava.php?api_key=YOUR_API_KEY&sehir=Istanbul

Örnek Yanıt

{
    "success": true,
    "data": {
        "guncelleme": "2024-01-15 14:30:00",
        "adet": 1,
        "veriler": [
            {
                "sehir": "İstanbul",
                "sicaklik": 12.5,
                "nem": 65,
                "ruzgar": 15.2,
                "durum_kodu": 3
            }
        ]
    }
}

Domain WHOIS

Herhangi bir domain adının WHOIS kayıt bilgilerini anlık olarak sorgular. Her istek, doğrudan ilgili TLD'nin WHOIS sunucusuna TCP bağlantısı kurarak yanıt döner. Önbellekleme yapılmaz; cron gerektirmez.

Endpoint

GET /api/v1/whois.php

Parametreler

Desteklenen Uzantılar (Örnekler)

500'den fazla TLD desteklenmektedir. .tr ve .com.tr dahil tüm ccTLD'ler ve gTLD'ler için WHOIS sunucusu tanımlıdır.

Örnek İstekler

# Standart .com sorgusu
GET /api/v1/whois.php?api_key=YOUR_API_KEY&domain=example.com

# Türk uzantısı sorgusu
GET /api/v1/whois.php?api_key=YOUR_API_KEY&domain=ornek.com.tr

# cURL ile Header kimlik doğrulaması
curl -X GET "https://api.shentaweb.com/api/v1/whois.php?domain=example.com" \
     -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt — Kayıtlı Domain

{
    "success": true,
    "data": {
        "domain": "example.com",
        "tld": "com",
        "whois_sunucu": "whois.verisign-grs.com",
        "kayitli": true,
        "kayit_tarihi": "1995-08-14",
        "guncelleme_tarihi": "2024-08-14",
        "bitis_tarihi": "2025-08-13",
        "tescil_eden": "RESERVED-Internet Assigned Numbers Authority",
        "tescil_sahibi": "IANA",
        "durum": [
            "clientDeleteProhibited",
            "clientTransferProhibited",
            "clientUpdateProhibited"
        ],
        "isim_sunuculari": [
            "a.iana-servers.net",
            "b.iana-servers.net"
        ],
        "ham_veri": "Domain Name: EXAMPLE.COM\r\n..."
    }
}

Örnek Yanıt — Kayıtsız (Müsait) Domain

{
    "success": true,
    "data": {
        "domain": "musteridomain12345.com",
        "tld": "com",
        "whois_sunucu": "whois.verisign-grs.com",
        "kayitli": false,
        "kayit_tarihi": null,
        "guncelleme_tarihi": null,
        "bitis_tarihi": null,
        "tescil_eden": null,
        "tescil_sahibi": null,
        "durum": [],
        "isim_sunuculari": [],
        "ham_veri": "No match for \"MUSTERIDOMAIN12345.COM\"."
    }
}

Yanıt Alanları

Önemli Notlar

• Her istek WHOIS sunucusuna anlık TCP bağlantısı kurarak yanıt alır; önbellekleme yapılmaz.
• domain parametresini sadece example.com formatında gönderin; http:// veya www. öneki gerekmez (gönderilse bile otomatik temizlenir).
• .com.tr ve .tr uzantıları tam desteklidir — whois.nic.tr sunucusu üzerinden sorgulanır.
• GDPR/gizlilik koruması aktif domainlerde tescil_sahibi, kayit_tarihi gibi alanlar null dönebilir; bu normaldir.
• WHOIS sunucusunun erişilemez veya yanıt vermediği nadir durumlarda 503 hata kodu döner.
• Bazı yeni nesil TLD'lerin WHOIS sunucusu standart dışı yanıt üretebilir; bu durumda ham_veri alanını inceleyebilirsiniz.

IP Sorgulama

Verilen IPv4 veya IPv6 adresine ait coğrafi konum, organizasyon, ISP, hosting ve proxy bilgilerini anlık olarak döner. ip parametresi gönderilmezse isteği yapan kullanıcının IP'si sorgulanır.

Endpoint

GET /api/v1/ip.php

Parametreler

Örnek İstekler

# Belirli bir IPv4 adresi
GET /api/v1/ip.php?api_key=YOUR_API_KEY&ip=8.8.8.8

# IPv6 adresi sorgusu
GET /api/v1/ip.php?api_key=YOUR_API_KEY&ip=2001:4860:4860::8888

# ip parametresi verilmezse kendi IP'nizi sorgularsınız
GET /api/v1/ip.php?api_key=YOUR_API_KEY

# Hosting IP kontrolü (sunucu mu, kişisel mi?)
GET /api/v1/ip.php?api_key=YOUR_API_KEY&ip=104.26.12.74

# cURL ile Header kimlik doğrulaması
curl -X GET "https://api.shentaweb.com/api/v1/ip.php?ip=1.1.1.1" \
     -H "Authorization: Bearer YOUR_API_KEY"

Örnek Yanıt — Hosting/Veri Merkezi IP

{
    "success": true,
    "data": {
        "ip": "8.8.8.8",
        "tip": "IPv4",
        "ozel_ag": false,
        "hostname": "dns.google",
        "ulke": "US",
        "ulke_kodu": "US",
        "sehir": "Mountain View",
        "bolge": "California",
        "posta_kodu": "94043",
        "enlem": 37.4056,
        "boylam": -122.0775,
        "saat_dilimi": "America/Los_Angeles",
        "org": "Google LLC",
        "as": "AS15169",
        "as_tam": "AS15169 Google LLC",
        "hosting": null,
        "proxy": null,
        "guncelleme": "2025-01-15 14:30:00"
    }
}

Örnek Yanıt — Özel/Yerel Ağ IP

{
    "success": true,
    "data": {
        "ip": "192.168.1.1",
        "tip": "IPv4",
        "ozel_ag": true,
        "aciklama": "Bu IP adresi özel/yerel bir ağ adresidir (RFC 1918 / loopback). Coğrafi bilgi mevcut değildir.",
        "ulke": null,
        "sehir": null,
        "bolge": null,
        "enlem": null,
        "boylam": null,
        "org": null,
        "guncelleme": "2025-01-15 14:30:00"
    }
}

Yanıt Alanları

Önemli Notlar

• Coğrafi konum bilgisi yaklaşık olup şehir/posta kodu düzeyindedir; kesin ev/ofis adresi tespit edilemez.
• Özel ağ adresleri (192.168.x.x, 10.x.x.x, 172.16-31.x.x, ::1 vb.) için ozel_ag: true döner; coğrafi bilgi yoktur.
• ip parametresi boş bırakılırsa isteği gönderen kullanıcının genel IP adresi sorgulanır. Proxy/load balancer varsa X-Forwarded-For başlığındaki ilk IP kullanılır.
• hosting ve proxy alanları yalnızca belirli planlarda mevcuttur; desteklenmeyen planlarda null döner.
• IPv6 adresleri için konum bilgisi IPv4'e kıyasla daha sınırlı olabilir.

Namaz Vakitleri

Türkiye'deki 81 il için tüm günlük namaz vakitlerini (İmsak, Güneş, Öğle, İkindi, Akşam, Yatsı) döner. Vakitler Diyanet İşleri Başkanlığ�� hesap metoduyla hesaplanır, her gece otomatik olarak güncellenir. Talep edilen tarih cache'de yoksa anlık API'den hesaplanarak yanıtlanır.

Endpoint

GET /api/v1/namaz.php

Parametreler

Örnek İstekler

# Bugünkü İstanbul vakitleri
GET /api/v1/namaz.php?api_key=YOUR_API_KEY&sehir=istanbul

# Belirli bir tarih için Ankara
GET /api/v1/namaz.php?api_key=YOUR_API_KEY&sehir=ankara&tarih=2026-03-25

# 7 günlük takvim
GET /api/v1/namaz.php?api_key=YOUR_API_KEY&sehir=bursa&mod=takvim

# Tüm iller özet listesi
GET /api/v1/namaz.php?api_key=YOUR_API_KEY

Örnek Yanıt

{
    "success": true,
    "data": {
        "sehir": "İstanbul",
        "slug": "istanbul",
        "tarih": "2026-03-25",
        "gun": "Çarşamba",
        "vakitler": {
            "imsak":  "05:14",
            "gunes":  "06:40",
            "ogle":   "13:10",
            "ikindi": "16:30",
            "aksam":  "19:35",
            "yatsi":  "20:56"
        },
        "aktif_vakit": "ogle",
        "sonraki_vakit": {
            "vakit": "ikindi",
            "saat": "16:30"
        },
        "metod": "Aladhan — method=13 (Diyanet)",
        "guncelleme": "2026-03-25 01:31:42"
    }
}

Yanıt Alanları

Desteklenen İller

Önemli Notlar

• İl slug'ları küçük harfle, Türkçe karakter kullanmadan girilmelidir: istanbul, sanliurfa, afyonkarahisar
• tarih parametresi verilmezse bugünün tarihi kullanılır. Format: YYYY-MM-DD (örn: 2026-03-25)
• Veriler her gece saat 01:30'da otomatik olarak tüm iller için güncellenir (7 günlük takvim). Cron çalışmadan önce gelen istekler anlık hesaplanarak yanıtlanır.
• Vakitler Diyanet İşleri Başkanlığı'nın kullandığı Method 13 ile hesaplanır; resmi Diyanet takvimi ile uyumludur.
• aktif_vakit, isteğin yapıldığı saate göre dinamik olarak hesaplanır — cache'deki statik veri değildir.