ما هو API هواتف وماذا يقدم؟

موقع هواتف يقدم لجميع المطورين واجهة برمجية API مباشرة وسهلة وبذلك يستطيع أي مطور أو مبرمج أو صاحب موقع أن يستفيد من محتوى موقع هواتف بكل سهولة ويسر.


الواجهة البرمجية الحالية في أول إصداراتها وتوفر خدمة الاستعلام عن طريق محرك بحث الموقع وجلب تفاصيل مطعم وأرقام هواتفه.


وبإذن الله سيتم تطوير الـ API ليوفر خدمة إضافة الأرقام إلى هواتف...
والخصائص الأخرى التي سيتم إضافتها في الموقع إن شاء الله

خدمة البحث عن الأرقام

لإستخدام هذه الخدمة، بإمكانك طلب الرابط:

http://api.hawatef.org/get.php?format=xml&q={كلمات البحث تكون هنا}

مثال:

ولطلب رقم مطعم، عليك بإضافة كلمات البحث بالشكل التالي:

http://api.hawatef.org/get.php?format=xml&q=كودو الدمام

لاحظ كون قيمة البحث تكون مضمنة للمتغير q



خدمة إضافة رقم مطعم جديد

عفواً، الخدمة غير متوفرة في الـ API حالياً.



لتفاصيل استخدام خدمة البحث عن الأرقام، انتقل إلى التبويب التالي.

شرح خدمة البحث (XML)

كتطبيق عملي، سيتم الشرح بإستخدام نتيحة البحث عن "كودو الدمام":

http://api.hawatef.org/get.php?format=xml&q=كودو الدمام

حيث نتيجة الإستعلام ستكون بالشكل التالي:


<?xml version="1.0" encoding="utf-8"?>
<hawatefs>
	<hawatef> 
		<id>6</id>
		<name>كودو</name> 
		<city>الدمام</city>
		<street>الشارع الأول</street> 
		<phone1>03-8306252</phone1>
		<phone2>03-8302930</phone2> 
		<phone3></phone3>
		<phone4></phone4>
	</hawatef>
	<hawatef>
		<id>7</id>
		<name>كودو</name>
		<city>الدمام</city> 
		<street>حي أحد</street>
		<phone1>03-8180778</phone1>
		<phone2></phone2>
		<phone3></phone3>
		<phone4></phone4>
	</hawatef>
</hawatefs>



إذا لم يتم العثور على نتيجة لكلمات البحث المستخدم، سيتم عرض رسالة الخطأ التالية:


<?xml version="1.0" encoding="utf-8"?>
<hawatefs>
    <noresult> لا توجد نتائج للمطعم الذي تبحث عنه .. فضلاً ساعدنا بإضافته إلى قاعدة البيانات</noresult>
</hawatefs>


قريباً سيتاح الاستعلام عن طريق JSON

الإصدار: 0.0.90