Namaz Vakitleri API

İçindekiler

API Hakkında
Dokümantasyon
İstek Örnekleri
Bazı Şehir İsmi İstisnaları
Lisans
İletişim

API Hakkında

Bu repo, Php diliyle geliştirilmiş olan namaz vakitlerini sunan API'nin dokümantasyonunu içerir.

API, namaz vakitlerini ve API anahtarı bilgilerini sunan iki farklı endpoint'ten oluşmaktadır. Namaz vakitlerini sunan endpoint HTTP GET istekleriyle il, ilce ve api_key parametrelerini alır ve belirtilen şehrin namaz vakitlerini 14 gün sonrasına kadar JSON formatında sağlar

API anahtarı bilgilerini sunan endpoint ise kullanıcının API anahtarının seviyesini, aylık istek sınırını ve kalan istek sayısını JSON formatında sağlar.

Dokümantasyon

Base URL: https://toktasoft.com/api/namaz-vakitleri/

Ana Endpoint

URL: https://toktasoft.com/api/namaz-vakitleri/vakitler.php

Bu endpoint 3 farklı parametre almaktadır.

Parametre	Zorunlu Mu?	Açıklama
`il`	evet	İl adı
`ilce`	hayır	İlçe adı Parametre girilmezse merkez ilçenin vakitleri döndürülür.
`api_key`	evet	Kullanıcının API anahtarı

API Anahtar Bilgilerini Sunan Endpoint

URL: https://toktasoft.com/api/namaz-vakitleri/apikey.php

Bu endpoint sadece 1 parametre almaktadır.

Parametre	Zorunlu Mu?	Açıklama
`api_key`	evet	Kullanıcının API anahtarı

API Anahtar Seviyeleri ve Aylık Sınırları

API anahtarı sahibi olabilmek için iletişime geçilmesi gerekilmektedir.

Seviye	Aylık İstek Sınırı
Bronz	100
Gümüş	500
Altın	1.000
Platin	5.000
Elmas	10.000
VIP	Sınırsız

İstek Örnekleri

İstek örnekleri curl komut satırı aracı kullanılarak gösterilmiştir.

✅Manisa merkez ilçenin vakitleri

Merkez ilçeler için ilçe parametresi yazılmayabilir veya ilçe parametresine ilin adı yazılabilir.

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=manisa"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=manisa&ilce=manisa"

{
  "success": true,
  "result": [
    {
      "tarih": "29-07-2024",
      "imsak": "04:23",
      "sabah": "06:02",
      "ogle": "13:22",
      "ikindi": "17:13",
      "aksam": "20:31",
      "yatsi": "22:04"
    },
    {
      "tarih": "30-07-2024",
      "imsak": "04:24",
      "sabah": "06:03",
      "ogle": "13:22",
      "ikindi": "17:13",
      "aksam": "20:30",
      "yatsi": "22:02"
    },
    ...
  ],
  "today": "29 Temmuz Pazartesi",
  "city": "Manisa",
  "district": null,
  "monthly_request_count": 84
}

❌Yanlış İstek

Kocaeli gibi merkez ilçenin adı il adından farklı olan bölgelerde merkez ilçe vakit bilgileri için ilçe parametresine ilçenin adı değil Manisa örneğindeki gibi ilin adı yazılmalıdır. Kocaeli'de merkez ilçenin adı İzmit'tir.

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=kocaeli&ilce=izmit"

{
  "success": false,
  "error": "Geçersiz ilçe parametresi.",
  "monthly_request_count": 106
}

✅Elazığ merkez ilçenin vakitleri

Adında ingilizce karakter dışında karakter bulunan il - ilçe farketmeksizin şehir isimleri olduğu gibi yada ingilizce karakterlerle yazılabilir ve büyük küçük harf duyarlı değildir.

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=Elazığ"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=manisa&ilce=elazig"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=manisa&ilce=ElaZIg"

{
  "success": true,
  "result": [
    {
      "tarih": "30-07-2024",
      "imsak": "03:37",
      "sabah": "05:16",
      "ogle": "12:35",
      "ikindi": "16:26",
      "aksam": "19:43",
      "yatsi": "21:15"
    },
    {
      "tarih": "31-07-2024",
      "imsak": "03:38",
      "sabah": "05:17",
      "ogle": "12:35",
      "ikindi": "16:25",
      "aksam": "19:42",
      "yatsi": "21:14"
    },
    ...
  ],
  "today": "30 Temmuz Salı",
  "city": "Elazığ",
  "district": null,
  "monthly_request_count": 122
}

✅Manisa'nın Akhisar ilçesinin vakitleri

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=manisa&ilce=akhisar"

{
  "success": true,
  "result": [
    {
      "tarih": "30-07-2024",
      "imsak": "04:21",
      "sabah": "06:01",
      "ogle": "13:20",
      "ikindi": "17:12",
      "aksam": "20:29",
      "yatsi": "22:02"
    },
    {
      "tarih": "31-07-2024",
      "imsak": "04:23",
      "sabah": "06:02",
      "ogle": "13:20",
      "ikindi": "17:11",
      "aksam": "20:28",
      "yatsi": "22:01"
    },
    ...
  ],
  "today": "30 Temmuz Salı",
  "city": "Manisa",
  "district": "Akhisar",
  "monthly_request_count": 187
}

❌Yanlış İstek

İl - ilçe isimleri uyuşmazsa hata döndürülür.

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=kutahya&ilce=akhisar"

{
  "success": false,
  "error": "Geçersiz ilçe parametresi.",
  "monthly_request_count": 201
}

✅Apikey hakkında bilgiler

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/apikey.php?api_key=myapikey"

{
  "success": true,
  "result": {
    "api_key": "myapikey",
    "api_level": "Gümüş",
    "max_requests_per_month": 500,
    "remaining_requests": 422
  },
  "monthly_request_count": 78
}

Bazı Şehir İsmi İstisnaları

Farklı illerde bulunan bazı ilçeler aynı isimlere sahip olabiliyor. Bu yüzden bu ilçeler için istisnai istek isimleri belirlendi.

Aydın - Bilecik | Yenipazar

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=bilecik&ilce=yenipazar"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=aydin&ilce=yenipazar-a"

Antalya - Burdur | Kemer

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=antalya&ilce=kemer"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=burdur&ilce=kemer-b"

Antalya - Isparta | Aksu

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=antalya&ilce=aksu"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=isparta&ilce=aksu-i"

Denizli - Kastamonu | Bozkurt

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=denizli&ilce=bozkurt"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=kastamonu&ilce=bozkurt-k"

Kayseri - Kastamonu | Pınarbaşı

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=kayseri&ilce=pinarbasi"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=kastamonu&ilce=pinarbasi-k"

Rize - Tokat | Pazar

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=rize&ilce=pazar"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=tokat&ilce=pazar-t"

Manisa - Trabzon | Köprübaşı

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=manisa&ilce=koprubasi"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=trabzon&ilce=koprubasi-t"

Balıkesir - Van | Edremit

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=balikesir&ilce=edremit"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=van&ilce=edremit-v"

Tekirdağ - Van | Saray

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=tekirdag&ilce=saray"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=van&ilce=saray-v"

Mersin - Yozgat | Aydıncık

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=mersin&ilce=aydincik"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=yozgat&ilce=aydincik-y"

Tunceli - Karabük | Ovacık

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=tunceli&ilce=ovacik"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=karabuk&ilce=ovacik-k"

Çanakkale - Karabük | Yenice

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=canakkale&ilce=yenice"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=karabuk&ilce=yenice-k"

Burdur - Sivas | Altınyayla

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=burdur&ilce=altinyayla"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=sivas&ilce=altinyaylas"

Konya - Zonguldak | Ereğli

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=konya&ilce=eregli"

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=zonguldak&ilce=karadeniz-eregli"

Diğer İstisnai Şehir İstek İsimleri

Isparta | Şarkikaraağaç

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=isparta&ilce=sarki-karaagac"

Isparta | Yenişarbademli

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=isparta&ilce=yenisar-bademli"

Tekirdağ | Marmaraereğlisi

curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=tekirdag&ilce=mereglisi"

Lisans

Copyright 2024 Mustafa TOKTAŞ

Licensed under the GNU General Public License v3.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    https://www.gnu.org/licenses/gpl-3.0.html

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.