هل تتساءل عن كيفية الحصول على مفتاح Yelp API ودمجه في موقع الويب أو التطبيق الخاص بك؟ لقد قمنا بإعداد مقال تفصيلي لشرح الأسئلة الأكثر شيوعًا.
ما هي Yelp API؟

تسمح واجهة برمجة تطبيقات Yelp Fusion لمستخدميها بالحصول على محتوى محلي ومراجعات المستخدمين من ملايين الشركات في مجال الضيافة والخدمات عبر 32 دولة. يمكن استخدام محتوى Yelp لأغراض تطوير التطبيقات والمواقع الإلكترونية.

كيف أحصل على مفتاح Yelp API؟

الحصول على مفتاح Fusion API الخاص بك سريع وسهل. للقيام بذلك ، عليك اتباع إرشادات Yelp API البسيطة هذه.

الخطوة 1 – قم بإنشاء حساب

أولاً ، عليك تسجيل الدخول إلى بوابة المطورين باستخدام حساب Yelp الحالي الخاص بك أو إنشاء حساب جديد

يمكنك متابعة العمل مع خدمة Yelp من خلال حساب Facebook أو Google أو Apple. الخيار الآخر هو التسجيل بعنوان بريدك الإلكتروني. في هذه الحالة ، ستتلقى رسالة تأكيد بالبريد الإلكتروني – لا تنس اتباع الرابط الموجود فيه للتحقق من حسابك.

سيتعين عليك التحقق من أنك لست روبوتًا عن طريق إكمال reCaptcha.

الخطوة 2 – ابدأ مع Fusion API

بمجرد تسجيل الدخول إلى خدمة مطوري Yelp ، قم بالتمرير لأسفل إلى أسفل الصفحة الأولى واضغط على الزر Explore Yelp Fusion.

سوف تصل إلى قسم Fusion API في البوابة. اضغط على زر البدء.

الخطوة 3 – إنشاء تطبيق

أنشئ تطبيق Yelp الأول الخاص بك لتلقي مفتاح Fusion API الشخصي الخاص بك. املأ الحقول المطلوبة في النموذج ، ووافق على شروط استخدام Yelp API ومتطلبات العرض. ثم أثبت أنك إنسان ، واضغط على إنشاء تطبيق جديد.

اقرأ أيضاً :  كيفية فتح مستند وإنشائه وإغلاقه وحفظه في Microsoft Word باستخدام لوحة المفاتيح

بعد ذلك ستحصل على معرف التطبيق ومفتاح API. احفظها لبدء العمل مع تطبيقك.

تذكر أن تحتفظ بمفتاح Yelp API الشخصي لنفسك! إنها بيانات اعتماد مكالمتك إلى Yelp’s API ويجب أن تستخدمها أنت فقط.

كيفية استخدام Yelp API؟

هناك عدة أنواع من واجهات برمجة التطبيقات ، والتي يمكن تقسيمها أساسًا إلى حلول للشركات الصغيرة أو المؤسسات والشركات المتوسطة أو الكبيرة وشركاء Yelp المحتملين. يتم تضمين أولها في Yelp Fusion API وهي متاحة للجميع مجانًا. يتطلب الأخير وصولاً خاصًا ، يتعين عليك تقديم طلب للحصول عليه وانتظار قرار الشركة.

يمكن استخدام محتوى Yelp لأغراض تطوير التطبيقات ومواقع الويب لمساعدة المستخدمين في العثور على أفضل الأماكن ومقدمي الخدمات في منطقة معينة ، ومقارنتها بالتقييم ومراجعات العملاء. تستخدم Yelp Fusion API مصادقة المفتاح الخاص لمصادقة جميع نقاط النهاية.

التسعير والحدود

جميع الحلول مفتوحة ومتاحة مجانًا للوصول القياسي. على الرغم من وجود حدود Yelp API للمكالمات ذات أحجام حد الأسعار الإضافية المقدمة لكل حالة على حدة. هذا يعني أنه يجب عليك التقدم لهم بوصف مشروعك بكامل إمكاناته. بعد ذلك سوف تنتظر قرارهم.

لدى Yelp API عدة أنواع من الحدود. الأول هو تحديد معدل QPS والذي يرمز إلى الاستعلامات في الثانية. إذا قمت بإجراء استعلامات ضد Yelp API بسرعة كبيرة ، فقد تحصل على أخطاء HTTP 429. إذا كنت ترى الخطأ بانتظام ، فحاول إبطاء معدل إجراء مكالمات واجهة برمجة التطبيقات.

بالإضافة إلى QPS ، هناك أيضًا حد لعدد طلبات API يوميًا.

بشكل افتراضي ، يقتصر أي عميل على 5000 استدعاء لواجهة برمجة التطبيقات لكل 24 ساعة. يتم إعادة تعيين هذا العدد كل منتصف الليل بالتوقيت العالمي المنسق. يتم عرض مكالماتك المتبقية ، بالإضافة إلى الحد الأقصى لعدد المكالمات والوقت الذي سيتم فيه تجديد الحد الخاص بك في رأس كل رد.
RateLimit-DailyLimit الحد الأقصى لعدد المكالمات التي يمكن للمستخدم إجراؤها في اليوم
RateLimit المتبقي عدد المكالمات المتبقية خلال اليوم الحالي
RateLimit-ResetTime الوقت الذي ستنتهي فيه نافذة حد السعر الحالي

أمثلة Yelp API

واجهة برمجة تطبيقات مراجعات Yelp

اقرأ أيضاً :  تطبيق Noom: عد السعرات الحرارية وحافظ على لياقتك

هذا النوع من الاستعلام هو مثال على واجهة برمجة تطبيقات Yelp Fusion والذي يتيح الفرصة لعرض ما يصل إلى ثلاثة مقتطفات من المراجعة لنشاط تجاري. هناك أيضًا حل Private Yelp Review API الذي يوفر وسيلة لشركاء Yelp المعتمدين لاسترداد المراجعات التي يمكن عرضها بشكل عام على النظام الأساسي.

Yelp Business API

يوفر Fusion API مجموعة كاملة من نقاط نهاية الأعمال التي تعرض محتوى أعمال مفصلاً.

هذه هي نقاط النهاية الأساسية المستخدمة:

اسم طريق وصف
بحث الأعمال / الشركات / البحث البحث بالكلمة الرئيسية ، الفئة ، الموقع ، مستوى السعر ، إلخ.
بحث الهاتف / شركات / بحث / هاتف البحث عن طريق رقم الهاتف.
البحث عن المعاملات / Transaction / {transaction_type} / بحث ابحث عن الخدمات التي تدعم معاملات توصيل الطعام.
تفاصيل العمل / business / {id} احصل على بيانات الأعمال الكاملة ، مثل الاسم والعنوان ورقم الهاتف والصور وتقييم Yelp ومستويات الأسعار وساعات العمل.
مباراة العمل / شركات / مباريات ابحث عن موقع Yelp التجاري الذي يتطابق مع موقع إدخال دقيق.

Yelp Search API

تقوم نقطة النهاية هذه بإرجاع ما يصل إلى 1000 شركة بناءً على معايير البحث المقدمة. لديها بعض المعلومات الأساسية حول العمل. تتضمن واجهة برمجة تطبيقات Fusion Search مجموعة متنوعة من الفئات التي تشمل الفنون والجمال والتمويل التعليمي وغيرها الكثير. يمكن العثور على القائمة الكاملة لفئات Yelp API هنا . لا تقوم واجهة برمجة التطبيقات بإرجاع الأعمال دون أي مراجعات.

تغييرات Yelp API

استخدم الإصدار v2 OAuth 2.0 لمصادقة الطلبات لواجهة برمجة التطبيقات. من أجل تبسيط هذه العملية ، بدءًا من 1 مارس 2018 ، انتقلت واجهة برمجة التطبيقات إلى API Keys فقط ولم تعد تستخدم OAuth 2.0 لطلبات البحث.

باستخدام OAuth 2.0 ، كانت عملية المصادقة كما يلي:

احصل على معرف العميل الخاص بك من تطبيق الإدارة.

اقرأ أيضاً :  كيفية استرداد أو إعادة تنشيط أو فتح حساب Twoo

قم بتقديم طلب إلى نقطة نهاية الرمز المميز للحصول على رمز وصول.

ضع رمز الوصول داخل رأس الطلب وابدأ في تقديم طلبات مقابل واجهة برمجة التطبيقات.

باستخدام مفاتيح API فقط ، تكون هذه العملية:

احصل على مفتاح API الخاص بك في صفحة إدارة التطبيق.

ضع مفتاح API في عنوان الطلب.

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

وثائق واجهة برمجة تطبيقات Yelp Developer

يحتوي موقع مطوري Yelp على جميع أنواع دروس Yelp API التي تشرح مبادئ التشغيل والاستخدام العملي . هناك يمكنك أيضًا إنشاء تطبيقاتك والعمل مع Fusion API و Yelp GraphQL – لغة استعلام لواجهات برمجة التطبيقات. المجموعة الشاملة لوثائق المطورين التي تأخذ بعين الاعتبار واجهة برمجة تطبيقات الشريك الخاصة مذكورة في Yelp Developer Portal . لا يمكن الوصول إلى واجهات برمجة التطبيقات الإعلانية هذه وواجهات برمجة تطبيقات الحجز وغيرها إلا من خلال تقديم طلب.

اترك تعليقاً

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *

error: Content is protected !!