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.
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 |
İl adı |
|
hayır |
İlçe adı Parametre girilmezse merkez ilçenin vakitleri döndürülür. |
|
evet |
Kullanıcının API anahtarı |
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"{
"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
}
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"- 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"
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.
