البناء باستخدام Bookings API متاح الآن بشكل عام
في ديسمبر 2020، أصدرنا Bookings API في مرحلة تجريبية لتوسيع إمكانيات Square Appointments – نقطة بيعنا للجدولة والحجوزات والمدفوعات – إلى أي برنامج تابع لجهة خارجية. منذ إطلاق الإصدار التجريبي، كنا قريبين من مجتمع المطورين، وجمعنا تعليقات ذات مغزى ونعمل بجد لتقديم واجهة برمجة تطبيقات غنية بالميزات ترقى إلى معايير Square.
في 12 مايو 2022، أطلقنا Bookings API للتوافر العام، حيث يمكن للمطورين في الولايات المتحدة والمملكة المتحدة وكندا وأستراليا وإسبانيا واليابان الوصول إلى واجهة برمجة التطبيقات. توفر Bookings API وصولاً جديدًا إلى الميزات الرئيسية مع أذونات على مستوى البائع، الإضافة إلى الأذونات الحالية على مستوى المشتري، مثل القراءة والكتابة واستلام بيانات الويب هوك من Square Appointments. تدعم واجهة برمجة التطبيقات الآن أيضًا نقاط نهاية ListBookings بحيث يمكن للمطورين إرجاع مجموعة من حجوزات البائعين.
باستخدام Bookings API، يمكن للمطورين الآن تمكين بائعي Square من إدارة جميع حجوزات العملاء والمعلومات لتقديم تجربة مشترية مخصصة بناءً على تفاصيل الحجز من Square Appointments ، كل ذلك مع تطبيقاتهم. تتكامل واجهة برمجة التطبيقات (API) بسلاسة مع أي تطبيقات تابعة لجهات خارجية، بما في ذلك مواقع الويب المخصصة، مما يسهل على البائعين تقديم تجربة حجز على العلامة التجارية وإنشاء أدوات مخصصة للاستخدام في المنزل لتشغيل وتوسيع نطاق أعمالهم بكفاءة.
تم دمج Bookings API بعمق مع النظام البيئي لمطوري Square ، مما يعني أن المطورين ومنصات الجهات الخارجية يمكنهم تقليل تكلفة التطوير وإثراء تجربة تطبيقاتهم بسرعة وقضاء وقت أقل في بناء أنظمة الحجوزات وصيانتها. وهذا يعني أيضًا أنه يمكن للمطورين جذب بائعي Square الجدد وزيادة عدد الخدمات التي يقدمونها للعملاء.
كان Groupon ، وهو سوق تجارة إلكترونية عالمي يربط المشترين بالتجار المحليين، من بين أوائل شركاء Square لإلغاء تأمين تكامل الحجز السلس مع Bookings API. من خلال هذا التكامل، يمكن لـ Groupon توسيع مخزونها القابل للحجز وتحسين رحلة العميل، مما يجعل التجربة أكثر سلاسة من الشراء إلى الزيارة الأولى.
كيف تعمل Bookings API
يمكنك استخدام Bookings API لإنشاء تطبيقات قائمة على المواعيد تسمح لعميل بائع Square بحجز موعد لخدمة معينة يقدمها البائع أو أحد أعضاء فريق البائع.
لنفترض أنك تنشئ موقعًا مخصصًا لبائع سكوير يمتلك صالونًا لتصفيف الشعر. لقد منح البائع أذونات على مستوى البائع للتطبيق الخاص بك، بحيث يكون لديك رؤية كاملة لتقويم البائع والتحكم الكامل في حجوزات البائع.
عندما يزور أحد العملاء موقع الويب الخاص بك ويريد حجز موعد في صالون تصفيف الشعر، فإنك تبحث عن خدمات قابلة للحجز باستخدام نقطة SearchCatalogItemsالنهاية. بعد ذلك، حدد العميل الذي يطلب الحجز إما عن طريق إنشاء عميل جديد أو عن طريق الاتصال بنقطة SearchCustomersالنهاية. بعد ذلك، ابحث عن الفتحات المتاحة عن طريق استدعاء نقطة SearchAvailabilityنهاية Bookings API، كما هو موضح أدناه.
في SearchAvailabilityالرد ، تحصل على قائمة بالفترات الزمنية المتاحة للعميل للحجز. باستخدام معرّف العميل والفترات الزمنية المتاحة، يمكنك الآن الاتصال بنقطة CreateBookingالنهاية. هذا يرسل booking.createdحدث.
بمجرد إنشاء الحجز، يتم إنشاء معرف الحجز الذي يمكن استخدامه لاسترداد الحجز (عبر نقطة RetrieveBookingالنهاية) أو تحديث الحجز (عبر UpdateBookingنقطة النهاية). إذا تم تحديث حجز، booking.updatedيتم إرسال حدث.
يمكن للتطبيق الخاص بك استخدام webhooks لتلقي إشعارات الأحداث عند إنشاء حجز أو تحديثه والاستجابة وفقًا لاحتياجاتك. على سبيل المثال، عند إنشاء حجز، يمكنك إضافته إلى قائمة المواعيد القادمة للعميل. عندما يتم تحديث الحجز، يمكنك إخطار مزود الخدمة بالتغييرات. نظرًا لأن التطبيق لديه أذونات على مستوى البائع، يمكنك تلقي إشعارات الأحداث لأي حجز يمكن رؤيته في واجهة برمجة التطبيقات.
البدء
يسعدنا أن نرى ما ستنشئه باستخدام Bookings API. يمكنك التحقق من وثائق Bookings API لمعرفة المزيد. لمعرفة المزيد حول منصة مطوري Square ، تفضل بزيارة https://squareup.com/developers.
تحتاج مساعدة؟
إذا كنت بحاجة إلى مساعدة في التنفيذ أو لديك أي أسئلة، فتفضل بزيارة منتديات مطوري Square أو قم بالبناء باستخدام قناة Square Slack، أو اتصل بفريق دعم المطورين.
المصدر: developer
شاهد المزيد:
