Bu repo, 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.
Base URL: https://toktasoft.com/api/namaz-vakitleri/
URL: https://toktasoft.com/api/namaz-vakitleri/vakitler.php
Bu endpoint 3 farklı parametre almaktadır.
| Parametre | Zorunlu Mu? | Açıklama |
|---|---|---|
|
evet |
Kullanıcının API anahtarı |
|
evet |
İl adı |
|
hayır |
İlçe adı Parametre girilmezse merkez ilçenin vakitleri döndürülür. |
URL: https://toktasoft.com/api/namaz-vakitleri/apikey.php
Bu endpoint sadece 1 parametre almaktadır.
| Parametre | Zorunlu Mu? | Açıklama |
|---|---|---|
|
evet |
Kullanıcının API anahtarı |
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 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"{
"status": 200,
"monthly_request_count": 84,
"result": {
"today": "31 Mayıs Cumartesi",
"city": "Manisa",
"district": null,
"vakitler": [
{
"tarih": "31-05-2025",
"imsak": "03:54",
"sabah": "05:41",
"ogle": "13:13",
"ikindi": "17:07",
"aksam": "20:35",
"yatsi": "22:14"
},
{
"tarih": "01-06-2025",
"imsak": "03:54",
"sabah": "05:41",
"ogle": "13:13",
"ikindi": "17:07",
"aksam": "20:36",
"yatsi": "22:15"
},
...
]
},
"error": null
}❌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"{
"status": 400,
"monthly_request_count": 106,
"result": null,
"error": "Geçersiz ilçe parametresi"
}✅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=elazig"curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=ElaZİg&ilce=ElaZİg"{
"status": 200,
"monthly_request_count": 122,
"result": {
"today": "31 Mayıs Cumartesi",
"city": "Elazığ",
"district": "Elazığ",
"vakitler": [
{
"tarih": "31-05-2025",
"imsak": "03:07",
"sabah": "04:54",
"ogle": "12:26",
"ikindi": "16:20",
"aksam": "19:48",
"yatsi": "21:27"
},
{
"tarih": "01-06-2025",
"imsak": "03:06",
"sabah": "04:53",
"ogle": "12:26",
"ikindi": "16:20",
"aksam": "19:49",
"yatsi": "21:28"
},
...
]
},
"error": null
}✅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"{
"status": 200,
"monthly_request_count": 187,
"result": {
"today": "31 Mayıs Cumartesi",
"city": "Manisa",
"district": "Akhisar",
"vakitler": [
{
"tarih": "31-05-2025",
"imsak": "03:51",
"sabah": "05:39",
"ogle": "13:11",
"ikindi": "17:06",
"aksam": "20:34",
"yatsi": "22:14"
},
{
"tarih": "01-06-2025",
"imsak": "03:50",
"sabah": "05:38",
"ogle": "13:12",
"ikindi": "17:06",
"aksam": "20:35",
"yatsi": "22:15"
},
...
]
},
"error": null
}❌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"{
"status": 400,
"monthly_request_count": 201,
"result": null,
"error": "Geçersiz ilçe parametresi"
}✅Apikey hakkında bilgiler
curl -X GET "https://toktasoft.com/api/namaz-vakitleri/apikey.php?api_key=myapikey"{
"status": 200,
"monthly_request_count": 78,
"result": {
"api_key": "mustafa",
"api_level": "Bronz",
"max_requests_per_month": 500,
"remaining_requests": 422
},
"error": null
}
Farklı illerde bulunan ilçeler bazen aynı isimlere sahip olabiliyor. Bu yüzden bu ilçeler için istisnai istek isimleri belirlendi.
- Aydın ve Bilecik'te bulunan 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 ve Burdur'da bulunan 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 ve Isparta'da bulunan 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 ve Kastamonu'da bulunan 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 ve Kastamonu'da bulunan 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 ve Tokat'ta bulunan 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 ve Trabzon'da bulunan 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 ve Van'da bulunan 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ğ ve Van'da bulunan 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 ve Yozgat'ta bulunan 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 ve Karabük'te bulunan 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 ve Karabük'te bulunan 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 ve Sivas'ta bulunan 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 ve Zonguldak'ta bulunan 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"- Isparta'da bulunan Şarkikaraağaç
curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=isparta&ilce=sarki-karaagac"- Isparta'da bulunan Yenişarbademli
curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=isparta&ilce=yenisar-bademli"- Tekirdağ'da bulunan Marmaraereğlisi
curl -X GET "https://toktasoft.com/api/namaz-vakitleri/vakitler.php?api_key=myapikey&il=tekirdag&ilce=mereglisi"
Copyright 2024-2025 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.
