مراجعة WPGetAPI: قم بتوصيل WordPress بواجهات برمجة التطبيقات

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

يهدف WPGetAPI إلى تبسيط السماح لك بإرسال البيانات أو جلب البيانات من أي واجهة برمجة تطبيقات خارجية. إذا كنت تسحب البيانات من واجهة برمجة تطبيقات ، فيمكن أن تساعدك أيضًا في عرض تلك البيانات بسهولة أكبر على موقعك.

في مراجعة WPGetAPI العملية الخاصة بنا ، سنلقي نظرة مفصلة على ما يقدمه هذا المكون الإضافي ونوضح لك كيفية عمله.

مراجعة WPGetAPI: ماذا يفعل البرنامج المساعد؟

باختصار ، يجعل WPGetAPI من السهل توصيل موقع WordPress الخاص بك بواجهة برمجة تطبيقات REST خارجية دون الحاجة إلى كتابة رمز مخصص.

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

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

إذا لم تكن متأكدًا مما يعنيه ذلك بالضبط ، فإليك بعض الأمثلة لما قد تفعله باستخدام WPGetAPI ...

• قم بإحضار وعرض أحدث سعر لعملة مشفرة معينة باستخدام Binance API ، أو لمؤشر الأسهم باستخدام واحدة من العديد من واجهات برمجة التطبيقات المالية.
• أرسل بيانات طلب WooCommerce إلى واجهة برمجة تطبيقات خارجية - يمكنك استخدام هذا للمساعدة في التنفيذ وتتبع الشحن وأتمتة التسويق وغير ذلك الكثير.
• أرسل البيانات من نموذج إنشاء العملاء المحتملين إلى CRM الخاص بك. على سبيل المثال ، يمكنك تخزين معلومات الاتصال الخاصة بالمستخدم كعميل متوقع جديد ، إلى جانب تفاصيل أخرى.
• قم بإحضار بيانات المخزون من نظام إدارة المخزون الخاص بك للتحقق من مخزون المنتجات في متجر WooCommerce الخاص بك.
• قم بإحضار أحدث النتائج أو الإحصائيات الرياضية واعرضها على موقعك. على سبيل المثال ، يمكنك الحصول على درجات وإحصائيات كرة السلة باستخدام API-Basketball.
• قم بتوصيل موقعك بـ ChatGPT أو طرز AI الأخرى.
• إحضار بيانات التغذية الدقيقة للوصفة.

بالطبع ، هذه القائمة تخدش السطح فقط لأن هناك العديد من واجهات برمجة التطبيقات المختلفة الموجودة هناك. إذا كنت ترغب في العثور على واجهات برمجة التطبيقات التي يمكنك استخدامها على موقعك ، فإن RapidAPI Hub هو مكان رائع للبدء.

إذا كنت تريد أن ترى بعض الأمثلة الحية ، يمكنك التحقق من هذه الصفحة.

دعنا نتعمق قليلاً في الميزات التي يقدمها المكون الإضافي لمساعدتك في القيام بذلك ...

الميزات الرئيسية / التفاصيل الفنية

فيما يلي ملخص سريع لبعض الميزات الرئيسية والتفاصيل الفنية:

• إضافة عدد غير محدود من واجهات برمجة التطبيقات.
• أضف نقاط نهاية غير محدودة لكل واجهة برمجة تطبيقات.
• استخدم طرق GET و POST و PUT و DELETE.
• تنسيق النتائج كسلسلة JSON أو مصفوفة PHP أو XML (سلسلة) أو XML (مصفوفة).
• استخدم المفاتيح لسحب معلومات محددة من واجهات برمجة التطبيقات لعرضها على موقعك.
• أضف أزواج الاسم / القيمة لسلاسل الاستعلام والرؤوس وحقول POST للنص.
• تنسيق بيانات API تلقائيًا بتنسيق HTML - كل ما عليك فعله هو إضافة CSS.
• نتائج ذاكرة التخزين المؤقت لتحسين الأداء والتحكم في استخدام واجهة برمجة التطبيقات.
• استخدم الرموز المميزة للحصول على البيانات من موقع WordPress الخاص بك (مثل الاسم الأول للمستخدم من حساب مستخدم WordPress الخاص به).
• ربط عدة استدعاءات API معًا - على سبيل المثال ، يمكنك استخدام البيانات من استدعاء API واحد في استدعاء API لاحق.
• استدعاء واجهات برمجة التطبيقات باستخدام AJAX - على سبيل المثال ، يمكنك استدعاء API عندما ينقر المستخدم على زر.
• قم بتفويض واجهة برمجة التطبيقات الخاصة بك باستخدام تفويض OAuth 2.0 ( يتطلب وظيفة إضافية منفصلة ).

خيارات العرض

إذا كنت تقوم بجلب البيانات من واجهة برمجة تطبيقات خارجية ، فإن WPGetAPI يمنحك الكثير من الخيارات المختلفة لعرض تلك البيانات على موقعك.

تتمثل الخيارات الأكثر مرونة في استخدام الرمز القصير أو علامة القالب ، وكلاهما يوفر الكثير من المعلمات لتخصيص كيفية عرض البيانات.

على سبيل المثال ، يمكنك استخدام الرمز القصير لسحب مفاتيح معينة من واجهة برمجة التطبيقات وتنسيقها بتنسيق HTML في div (أو عناصر HTML أخرى).

هناك أيضًا سمات أخرى للرموز القصيرة لتحويل عنوان URL للصورة في نتيجة واجهة برمجة التطبيقات إلى صورة فعلية أو تحويل ارتباط إلى ارتباط قابل للنقر.

هناك أيضًا كتلة محرر تتيح لك عرض بيانات API ، على الرغم من أنها ليست مرنة مثل الرمز القصير أو علامات القالب.

وكما سترى في ثانية ، فإن WPGetAPI يتكامل أيضًا مع بعض المكونات الإضافية للسماح لك بعرض البيانات من خلال تلك المكونات الإضافية.

تكامل البرنامج المساعد

لمساعدتك على دمج واجهات برمجة التطبيقات في المكونات الإضافية التي تستخدمها بالفعل ، يتكامل WPGetAPI مع عدد من المكونات الإضافية الشائعة.

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

• كتب مريم الدخيل لاكاديمية الثراء
• عضوية مدفوعة برو
• LifterLMS

يتكامل WPGetAPI أيضًا مع المكونات الإضافية التالية للنماذج بحيث يمكنك تمرير البيانات من النموذج إلى واجهة برمجة التطبيقات:

• أشكال الجاذبية
• WPForms
• نموذج الاتصال 7

لمنحك المزيد من المرونة لعرض بيانات API ، يتكامل WPGetAPI مع المكون الإضافي wpDataTables بحيث يمكنك عرض بيانات API في جدول أو مخطط.

كيفية استخدام WPGetAPI

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

في هذا المثال الأول ، سنستخدم واجهة برمجة تطبيقات Quotable المجانية لجلب عرض أسعار عشوائي وعرضه على موقع WordPress الخاص بنا. على الرغم من أنه ليس المثال الأكثر إثارة ، فإن واجهة برمجة التطبيقات هي مثال جيد لأنها مجانية وسهلة الاستخدام.

ملاحظة - نحن نستخدم الإصدار الاحترافي من WPGetAPI لهذه الأمثلة ، ولكن هناك أيضًا نسخة مجانية وستكون العملية الأساسية هي نفسها في كلتا الحالتين. المزيد عن التسعير في وقت لاحق.

أضف واجهة برمجة تطبيقات جديدة

بمجرد تثبيت البرنامج المساعد وتنشيطه ، يمكنك الانتقال إلى WPGetAPI → Setup لإضافة API الأول الخاص بك.

في الشاشة الأولى ، ما عليك سوى إدخال بعض التفاصيل الأساسية.

يمكنك إضافة عدد غير محدود من واجهات برمجة التطبيقات ، حتى مع الإصدار المجاني من البرنامج المساعد.

قم بإعداد نقطة نهاية API

بمجرد إضافة API ، ستحصل على قائمة جديدة لواجهة برمجة التطبيقات تلك ضمن قائمة WPGetAPI الرئيسية. هذا هو المكان الذي يمكنك فيه إعداد نقاط النهاية لواجهة برمجة التطبيقات.

في هذا المثال ، ستذهب إلى WPGetAPI → Quotable .

هنا ، يمكنك تكوين ما يلي:

• عنوان URL لنقطة النهاية - يتم إلحاقه بعنوان URL الأساسي.
• الطريقة - GET أو POST أو PUT أو Delete.
• تنسيق النتائج - سلسلة JSON أو مصفوفة PHP أو XML (كسلسلة) أو XML (كمصفوفة).
• وقت ذاكرة التخزين المؤقت - كم من الوقت يتم تخزين بيانات الطلب مؤقتًا.
• سلسلة الاستعلام - يمكنك إضافة معامِلات غير محدودة لسلسلة الاستعلام في أزواج الاسم / القيمة.
• الرؤوس - يمكنك إضافة رؤوس غير محدودة كأزواج اسم / قيمة.
• حقول POST للجسم - يمكنك إضافة عدد غير محدود من حقول POST كأزواج اسم / قيمة. يمكنك أيضًا ترميزها كـ JSON أو URL أو XML.

في هذا المثال ، سنقوم بسحب عرض أسعار عشوائي من نقطة النهاية / العشوائية باستخدام طلب GET. سنخزن النتائج كسلسلة JSON ونخزنها مؤقتًا لمدة دقيقتين (120 ثانية).

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

بالنظر إلى إخراج البيانات ، يمكنك أن ترى أننا تمكنا من استرداد اقتباس عشوائي من Henry Moore بنجاح.

إذا كنت ترغب في إعداد نقاط نهاية إضافية ، يمكنك إضافة العديد حسب الحاجة - حتى الإصدار المجاني يدعم نقاط نهاية غير محدودة.

عرض بيانات API على موقعك

كما ذكرنا سابقًا ، يمنحك WPGetAPI الكثير من الخيارات المختلفة لعرض بيانات API على موقعك ، بما في ذلك الرموز القصيرة والكتل وعلامات القوالب وتكامل المكونات الإضافية والمزيد.

بالنسبة للرموز القصيرة وعلامات القوالب ، يمكنك الحصول عليها مباشرةً من واجهة تكوين نقطة النهاية ( أعلى نقطة نهاية الاختبار مباشرةً زر ).

أو ، إذا كنت تستخدم محرر الكتلة ، فيمكنك فقط استخدام كتلة WPGetAPI.

ومع ذلك ، يبدو أن الرمز القصير يمنحك أكبر قدر من المرونة ، لذلك هذا ما سنستخدمه.

عندما تستخدم الرمز القصير لأول مرة ، ستحصل فقط على المخرجات الأولية لطلب واجهة برمجة التطبيقات (مثل سلسلة JSON ، وصفيف PHP ، وما إلى ذلك).

لتنظيف هذا قليلاً ، يمكنك تغيير التنسيق إلى HTML عن طريق إضافة تنسيق = 'html' إلى الرمز القصير.

هذا يجعل الإخراج يبدو أفضل كثيرًا ، ويمكنك استخدام معلمات الرمز القصير الأخرى لإضافة كل جزء من البيانات على هيئة div أو span أو li.

ومع ذلك ، ربما لا تزال لديك بيانات غريبة وما زلت ترغب في تغيير التصميم قليلاً.

لتخصيص التصميم ، ستحتاج إلى استخدام CSS الخاص بك.

ومع ذلك ، لتخصيص البيانات التي سيتم عرضها ، يمكنك استخدام معلمة المفاتيح في الرمز القصير الخاص بك.

على سبيل المثال ، لعرض الاقتباس الفعلي والمؤلف فقط ، يمكنك إضافة مفاتيح = ”{content} ، {author}” .

الآن ، يبدو إخراج الواجهة الأمامية أكثر نظافة:

هذا هو الرمز المختصر الكامل وراء هذا:

[wpgetapi_endpoint api_ endpoint_ debug='false' format='html' keys="{content}, {author}"]

ملاحظة - لا يبدو أن كتلة المحرر تمنحك خيار تحديد المفاتيح لعرض أجزاء معينة فقط من البيانات. لهذا السبب ، من المحتمل أن ترغب في استخدام الرمز القصير في معظم الأوقات.

ماذا عن تمرير البيانات إلى واجهة برمجة تطبيقات خارجية؟

بالنسبة للمثال أعلاه ، نظرنا في جلب البيانات من واجهة برمجة التطبيقات لعرضها على موقعك. ولكن ماذا لو كنت تريد إرسال البيانات إلى واجهة برمجة تطبيقات خارجية بدلاً من ذلك؟

لتحقيق ذلك ، ستعمل أيضًا مع الرموز القصيرة.

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

عند إعداد نقطة النهاية ، قد ترغب في استخدام طلب PUT أو POST وأيضًا إعداد المعلومات التي تريد تمريرها إلى واجهة برمجة التطبيقات باستخدام سلاسل الاستعلام و / أو الرؤوس و / أو حقول POST الأساسية.

على سبيل المثال ، لنفترض أنك تريد إرسال بيانات طلب WooCommerce إلى واجهة برمجة تطبيقات. بالنسبة لحالة الاستخدام هذه ، يمكنك استخدام الرموز المميزة وإضافتها إلى إعدادات حقول POST الأساسية .

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

بعد ذلك ، يمكنك إضافة رمز WPGetAPI القصير لنقطة النهاية هذه في أي مكان على صفحة الخروج من WooCommerce.

لإطلاق هذا الطلب فقط على طلب WooCommerce ناجح ، يمكنك إضافة المعلمة التالية إلى الرمز القصير - on="woocommerce_order" .

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

تسعير WPGetAPI

من حيث التسعير ، يحتوي WPGetAPI على إصدار أساسي مجاني في WordPress.org بالإضافة إلى إصدار متميز يوسع الإصدار الأساسي بمجموعة من الميزات الجديدة.

في مراجعة WPGetAPI الخاصة بنا ، كنا نستخدم الإصدار المتميز. ومع ذلك ، لا يزال الإصدار المجاني يعمل ويدعم واجهات برمجة تطبيقات ونقاط نهاية غير محدودة.

فيما يلي بعض الميزات الرئيسية التي تحصل عليها مع الإصدار المتميز:

• الرموز
• المتغيرات الديناميكية
• خيار لربط استدعاءات API بحيث يمكنك استخدام البيانات من استدعاء واحد لواجهة برمجة التطبيقات في استدعاء لاحق لواجهة برمجة التطبيقات
• أرسل البيانات إلى واجهة برمجة التطبيقات (API) بعد أن يسجل المستخدم على موقعك
• أرسل البيانات إلى API عندما يكون هناك طلب WooCommerce جديد
• تكامل مع المكونات الإضافية الأخرى بما في ذلك Gravity Forms و WPForms ونموذج الاتصال 7 ومنشئ الصفحات
• خيار للتخزين المؤقت لاستدعاءات واجهة برمجة التطبيقات ، والذي يمكن أن يحسن الأداء ويوفر لك المال ( إذا كان استخدام واجهة برمجة التطبيقات يكلف المال )
• تنسيق بيانات JSON إلى HTML
• استرجاع البيانات المتداخلة

بشكل عام ، أود أن أقول إن معظم الناس سيرغبون في الإصدار المتميز. لكن الإصدار المجاني طريقة رائعة للتلاعب بها ومعرفة كيفية عملها على المستوى الأساسي.

يبدأ الإصدار الاحترافي بسعر 85 دولارًا سنويًا للاستخدام على موقع واحد أو 175 دولارًا للدعم / التحديثات مدى الحياة. سيكلفك ترخيص الموقع غير المحدود 125 دولارًا أو 285 دولارًا على التوالي.

بالإضافة إلى إصدار Pro من المكون الإضافي ، هناك أيضًا وظيفة إضافية متميزة منفصلة تدعم ترخيص OAuth 2.0 حتى تتمكن من الاتصال بواجهات برمجة التطبيقات التي تتطلب ذلك. تبدأ هذه الوظيفة الإضافية بسعر 65 دولارًا في السنة أو 155 دولارًا للدعم / التحديثات مدى الحياة.

الأفكار النهائية حول WPGetAPI

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

في حين أنه من الممكن العمل بدون رمز ، ما زلت أقول إنك تحتاج على الأقل إلى بعض الكفاءات التقنية الأساسية لاستخدام المكون الإضافي ، خاصة عندما تبدأ في الدخول في حالات استخدام أكثر تقدمًا.

كحد أدنى ، ربما تريد على الأقل بعض المعرفة الأساسية في CSS لتصميم إخراج البيانات التي تجلبها من خدمة خارجية.

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

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

وحتى لو كنت مبرمجًا بارعًا ، أود أن أقول إن إحدى الفوائد الكبيرة لـ WPGetAPI هي أنه يتيح لك تجنب الحاجة إلى ترميز الحل المخصص الخاص بك من البداية.

إذا كنت ترغب في تجربته ، يمكنك تثبيت الإصدار المجاني من WordPress.org للتعرف على ما يمكنه فعله.

إذا كنت تحب المفهوم الأساسي ، فربما ترغب بعد ذلك في الترقية إلى الإصدار المتميز لإلغاء قفل كل ما يمكن لـ WPGetAPI القيام به.