دليل إلى HTTP و وورد بريس HTTP API – الجزء 1

أثناء التحضير ، اعتقدت أنني سألقي نظرة على كيفية عمل HTTP بشكل عام وكيف يمكنك استخدام وظائف وورد بريس الأصلية للعمل معها ، وفتح منتجاتك للتكامل مع Twitter و Facebook و Mailchimp وجميع أنواع الأدوات الأخرى.

في هذه المقالة – الجزء 1 من 2 – سأوضح لك أساسيات طلبات HTTP ، وكيف يتم هيكلتها ، والمعلومات التي تحتوي عليها وكيفية فهمها. في الجزء الثاني سنضع معرفتنا موضع التنفيذ – من خلال وورد بريس.

ما هو HTTP

HTTP هو البروتوكول الرئيسي المستخدم على الويب اليوم ، وهو اختصار لـ Hypertext Transfer Protocol وهو مسؤول عن عرض HTML والصور والمزيد. عملاء HTTP – مثل متصفحك – يرسلون طلبات إلى خوادم HTTP التي ترسل استجابة .

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

أساسيات طلب HTTP

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

موارد

المورد هو جزء من البيانات التي يمكن تحديدها بعنوان URL. على سبيل المثال: http://myblog.com/my-awesome-articleربما يُرجع ملف HTML – الكود المطلوب لتقديم مقالتك الرائعة.

أسماء الطرق

تحدد أسماء الطرق نوع الإجراء الذي تريد تنفيذه على المورد. يستخدم المستعرض دائمًا GET مما يشير إلى أنك ترغب في استرداد المورد.

تتضمن الطرق الأخرى POST لإنشاء عناصر جديدة ، و PUT لتحديث العناصر ، و DELETE لحذف العناصر و HEAD للحصول على معلومات الرأس.

توفر أسماء الطرق هذه إلى جانب عناوين URL أساس واجهات برمجة تطبيقات REST. يمكنك إرسال طلب الحصول /article/4على لاسترداد المادة 4. يمكنك أيضًا إرسال طلب PUT مع بعض البيانات لتعديله ، أو طلب حذف لإزالته.

هيكل HTTP

طلبات واستجابات HTTP متشابهة جدًا من وجهة نظر هيكلية. كل جزء له أربعة أجزاء مميزة:

سطر أولي يختلف عن الطلب والاستجابة

رؤوس اختيارية تحتوي على معلومات حول الطلب أو الاستجابة

سطر فارغ

محتوى اختياري للجسم

1. السطر الأولي

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

GET /users/4 HTTP/1.1

لاحظ أن هذا السطر يحتوي على المسار النسبي المحلي وليس عنوان URL الكامل. يتم إرسال عنوان URL الأساسي في رأس (رأس المضيف) ، وسنلقي نظرة على الرؤوس قريبًا.

تحتوي الردود أيضًا على ثلاث أجزاء من المعلومات: إصدار HTTP ورمز الحالة والسبب الذي يصف رمز الحالة.

HTTP/1.1 302 Moved Temporarily

للحصول على قائمة بجميع رموز الحالة وقليلًا عن كل منها ، ألق نظرة على مواصفات أكواد حالة HTTP ، كل شيء واضح هناك.

2. الرؤوس

الرؤوس هي في الأساس أزواج من الاسم والقيمة من المعلومات. Hostالرأس المذكور سابقًا هو مثال جيد ، في الواقع ، هو الرأس الوحيد المطلوب في HTTP 1.1. تمنحك الرؤوس مزيدًا من التحكم والمزيد من المعلومات.

تريد أن تعرف كيف زدنا من حركة المرور لدينا أكثر من 1000 ٪؟

انضم إلى أكثر من 20000 آخرين ممن يتلقون رسائلنا الإخبارية الأسبوعية مع نصائح من الداخل حول وورد بريس!

إشترك الآن

و Acceptاسمحوا رأس هو تحديد نوع المحتوى الذي سيسمح في الطلب. و Accept-Languageاسمحوا رأس هو يمكنك التحكم في لغة المحتوى كنت على استعداد لقبول. كلاهما شكل من أشكال التفاوض على المحتوى .

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

3. الجسم

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

باستخدام HTTP

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

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

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

لفة

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

curl http://kinsta.com

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

curl -s -D - http://danielpataki.com -o /dev/null

يمكنك عرض قائمة بجميع المعلمات ولكن من المحتمل أنك ستستخدم cURL في تطبيق الويب الخاص بك ، لذلك دعونا نلقي نظرة على cURL في PHP ، وإليك كيفية الحصول على محتوى الصفحة نفسها:

$ch = curl_init();
$timeout = 5;
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, $timeout);
$data = curl_exec($ch);
curl_close($ch);
echo $data;

لا يزال هذا الأمر صعبًا بعض الشيء ولكن باستخدام دليل PHP ، يمكنك معرفة ما هو.

باستخدام ووردبريس

يعد cURL أمرًا رائعًا ، ولكن إضافة الترويسات والتعامل مع المعلومات التي يتم إرجاعها ليس بالسهولة التي قد تستخدمها إذا كنت تستخدم فئات ووظائف PHP مشفرة بشكل جيد. لحسن الحظ ، قام وورد بريس بتغطيتنا بواجهة برمجة تطبيقات HTTP الخاصة به. سنلقي نظرة عليها بالتفصيل في المقالة التالية ، في الوقت الحالي ، إليك مثال مع وظيفة وورد بريس الأصلية ، بما في ذلك إضافة الرؤوس:

$request = wp_remote_get('https://api.twitter.com/1.1/statuses/user_timeline.json?screen_name=kinsta, array(
    'headers' => array(
        'Authorization' => 'Bearer ' . $token,
    ),
));

ملخص

HTTP هو الأساس لكل ما نقوم به على الويب ومعرفة ما يجري في الطلب والاستجابة يعطينا إمكانات رائعة لاستكشاف الأخطاء وإصلاحها ويسمح لنا بالتحكم في تطبيقاتنا بشكل أفضل.

من خلال التعامل مع أساسيات HTTP ، ستتمكن من استخدام واجهات برمجة التطبيقات الخارجية بشكل أسرع وأفضل ، ومعرفة بالضبط ما يجب فعله بالمعلومات المقدمة لك في أدلة API.

في المنشور التالي في السلسلة ، سألقي نظرة على كيفية التعامل مع بيانات HTTP باستخدام وورد بريس وكيف يمكنك ربط وورد بريس بخدمة طرف ثالث بسهولة بالغة.

وفر الوقت والتكاليف وحقق أقصى قدر من أداء الموقع من خلال:

مساعدة فورية من خبراء استضافة وورد بريس ، 24/7.

تكامل Cloudflare Enterprise.

يصل الجمهور العالمي إلى 28 مركز بيانات حول العالم.

التحسين من خلال مراقبة أداء التطبيقات المضمنة لدينا.

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