Namaztimes.kz logo
 

API Облыстар мен аудандардың тізімі

REST API


REST API Namaztimes.kz сайтының дерекқорын қолдана отырып қарапайым HTTPS сұранысы арқылы Облыстар мен аудандардың тізімін алуға мүмкіндік береді.
REST API ақпараттарды JSON, XML форматтарында алуды қамтамасыз етеді. Барлық ақпараттар UTF-8 кодировкасы бойынша.

Анықтама


GET сұратым жіберу

https://namaztimes.kz/api/states[?id={country_id}][&type={format}]

API - HTTPS сұратымын қабылдайды.
Қолданымдағы форматтар JSON, XML.

{country_id}-ге бір елдің id нөмірін көрсетуге болады. Елдер тізімін мына жерден алуға болады

{format} арқылы деректерді xml, json форматын көрсетуге болады. Егер {format} көрсетілмесе онда автоматты түрде json форматы еніп, console.dir функциясы іске қосылады.

Сондықтан міндетті түрде іздеу боттарының сұратымдарын сүзгіден өткізіңіз. Мұны мынадай қарапайым түрде жүзеге асыруға болады:

$is_bot = preg_match(
"~(Google|Yahoo|Rambler|Bot|Yandex|Spider|Snoopy|Crawler|Finder|Mail|curl)~i",
$_SERVER['HTTP_USER_AGENT']
);
$result = !$is_bot ? json_decode(file_get_contents('https://namaztimes.kz/api/states?id={country_id}'), true) : [];
var_dump($result);

Сондай-ақ тұтынушы тарапынан 100 бет парақталған жағдайда, АРІ-ге 100 рет сұратым жасамау үшін сұратым нәтижелерін КЭШке сақтап алу қажет.

Қолдану мысалдары


GET https://namaztimes.kz/api/states?id=99

Бірегей нөмірі {country_id} = 99 болған ел туралы(Қазақстан) Облыстар мен аудандардың тізімін JSON форматында шығарады.

GET https://namaztimes.kz/api/states?id=99&type=xml

Бірегей нөмірі {country_id} = болған ел туралы(Қазақстан) Облыстар мен аудандардың тізімін XML форматында шығарады.

Нәтижелерге мысалдар


API-дің JSON форматы бойынша сұратым нәтижесі

    //GET https://namaztimes.kz/api/states?id=99
{
    Akmola: "Ақмола облысы",
    Aqtobe: "Ақтөбе облысы",
    Almaty: "Алматы облысы",
    ...
    East Kazakhstan: "Шығыс Қазақстан облысы"
}
    

API-дің XML форматы бойынша сұратым нәтижесі

    //GET https://namaztimes.kz/api/states?id=99&type=xml
<response>
	<state>
		<id>Akmola</id>
		<name>Ақмола облысы</name>
	</state>
	<state>
		<id>Aqtobe</id>
		<name>Ақтөбе облысы</name>
	</state>
	<state>
		<id>Almaty</id>
		<name>Алматы облысы</name>
	</state>
	...
	<state>
		<id>East Kazakhstan</id>
		<name>Шығыс Қазақстан облысы</name>
	</state>
</response>
    

Нәтижелердің анықтамасы


API-ге сұратым бойынша алған нәтижелердің анықтамасы.

JSON форматы бойынша

state: state_name

state - Облыс, аудан идентификаторы.

state_name - Облыс, аудан аты.

XML форматы бойынша

response-> state-> id, name

id - Облыс, аудан идентификаторы.

name - Облыс, аудан аты.