كيفية الحصول على مفتاح Yelp API واستخدامه: Fusion API و Business API
تسمح واجهة برمجة تطبيقات Yelp Fusion لمستخدميها بالحصول على محتوى محلي ومراجعات المستخدمين من ملايين الشركات في مجال الضيافة والخدمات عبر 32 دولة. يمكن استخدام محتوى Yelp لأغراض تطوير التطبيقات والمواقع الإلكترونية.
كيف أحصل على مفتاح Yelp API؟
الحصول على مفتاح Fusion API الخاص بك سريع وسهل. للقيام بذلك ، عليك اتباع إرشادات Yelp API البسيطة هذه.
الخطوة 1 – قم بإنشاء حساب
أولاً ، عليك تسجيل الدخول إلى بوابة المطورين باستخدام حساب Yelp الحالي الخاص بك أو إنشاء حساب جديد
يمكنك متابعة العمل مع خدمة Yelp من خلال حساب Facebook أو Google أو Apple. الخيار الآخر هو التسجيل بعنوان بريدك الإلكتروني. في هذه الحالة ، ستتلقى رسالة تأكيد بالبريد الإلكتروني – لا تنس اتباع الرابط الموجود فيه للتحقق من حسابك.
الخطوة 2 – ابدأ مع Fusion API
بمجرد تسجيل الدخول إلى خدمة مطوري Yelp ، قم بالتمرير لأسفل إلى أسفل الصفحة الأولى واضغط على الزر Explore Yelp Fusion.
سوف تصل إلى قسم Fusion API في البوابة. اضغط على زر البدء.
الخطوة 3 – إنشاء تطبيق
أنشئ تطبيق Yelp الأول الخاص بك لتلقي مفتاح Fusion API الشخصي الخاص بك. املأ الحقول المطلوبة في النموذج ، ووافق على شروط استخدام Yelp API ومتطلبات العرض. ثم أثبت أنك إنسان ، واضغط على إنشاء تطبيق جديد.
بعد ذلك ستحصل على معرف التطبيق ومفتاح API. احفظها لبدء العمل مع تطبيقك.
كيفية استخدام Yelp API؟
هناك عدة أنواع من واجهات برمجة التطبيقات ، والتي يمكن تقسيمها أساسًا إلى حلول للشركات الصغيرة أو المؤسسات والشركات المتوسطة أو الكبيرة وشركاء Yelp المحتملين. يتم تضمين أولها في Yelp Fusion API وهي متاحة للجميع مجانًا. يتطلب الأخير وصولاً خاصًا ، يتعين عليك تقديم طلب للحصول عليه وانتظار قرار الشركة.
يمكن استخدام محتوى Yelp لأغراض تطوير التطبيقات ومواقع الويب لمساعدة المستخدمين في العثور على أفضل الأماكن ومقدمي الخدمات في منطقة معينة ، ومقارنتها بالتقييم ومراجعات العملاء. تستخدم Yelp Fusion API مصادقة المفتاح الخاص لمصادقة جميع نقاط النهاية.
التسعير والحدود
جميع الحلول مفتوحة ومتاحة مجانًا للوصول القياسي. على الرغم من وجود حدود Yelp API للمكالمات ذات أحجام حد الأسعار الإضافية المقدمة لكل حالة على حدة. هذا يعني أنه يجب عليك التقدم لهم بوصف مشروعك بكامل إمكاناته. بعد ذلك سوف تنتظر قرارهم.
لدى Yelp API عدة أنواع من الحدود. الأول هو تحديد معدل QPS والذي يرمز إلى الاستعلامات في الثانية. إذا قمت بإجراء استعلامات ضد Yelp API بسرعة كبيرة ، فقد تحصل على أخطاء HTTP 429. إذا كنت ترى الخطأ بانتظام ، فحاول إبطاء معدل إجراء مكالمات واجهة برمجة التطبيقات.
بالإضافة إلى QPS ، هناك أيضًا حد لعدد طلبات API يوميًا.
| RateLimit-DailyLimit | الحد الأقصى لعدد المكالمات التي يمكن للمستخدم إجراؤها في اليوم |
| RateLimit المتبقي | عدد المكالمات المتبقية خلال اليوم الحالي |
| RateLimit-ResetTime | الوقت الذي ستنتهي فيه نافذة حد السعر الحالي |
أمثلة Yelp API
واجهة برمجة تطبيقات مراجعات Yelp
هذا النوع من الاستعلام هو مثال على واجهة برمجة تطبيقات 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 ، كانت عملية المصادقة كما يلي:
احصل على معرف العميل الخاص بك من تطبيق الإدارة.
قم بتقديم طلب إلى نقطة نهاية الرمز المميز للحصول على رمز وصول.
ضع رمز الوصول داخل رأس الطلب وابدأ في تقديم طلبات مقابل واجهة برمجة التطبيقات.
باستخدام مفاتيح API فقط ، تكون هذه العملية:
احصل على مفتاح API الخاص بك في صفحة إدارة التطبيق.
ضع مفتاح API في عنوان الطلب.
الآن ليست هناك حاجة لتقديم طلب إلى نقطة النهاية للحصول على رمز وصول. مفتاح API الخاص بك لا تنتهي صلاحيته ، لذلك لا داعي للقلق بشأن إنشاء مفاتيح جديدة.
وثائق واجهة برمجة تطبيقات Yelp Developer
يحتوي موقع مطوري Yelp على جميع أنواع دروس Yelp API التي تشرح مبادئ التشغيل والاستخدام العملي . هناك يمكنك أيضًا إنشاء تطبيقاتك والعمل مع Fusion API و Yelp GraphQL – لغة استعلام لواجهات برمجة التطبيقات. المجموعة الشاملة لوثائق المطورين التي تأخذ بعين الاعتبار واجهة برمجة تطبيقات الشريك الخاصة مذكورة في Yelp Developer Portal . لا يمكن الوصول إلى واجهات برمجة التطبيقات الإعلانية هذه وواجهات برمجة تطبيقات الحجز وغيرها إلا من خلال تقديم طلب.
