![](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D248BE0233D28263F53/ar_EG/fbd8d40651fff19a46e7aaedd4cb1b09.png)
طلب أول API في الاختصارات على Mac
لطلب أول API لك، يمكنك إنشاء URL الذي يشير إلى "نقطة نهاية" API التي تريد الاتصال بها، ثم تمرير هذا الـ URL إلى إجراء "إحضار محتويات عنوان URL". عند تشغيل الاختصار، يُصدِر هذا الإجراء طلب API.
![طلب واجهة API يحتوي على إجراء "عنوان URL" يشير إلى نقطة نهاية API، متبوعًا بإجراء "إحضار محتويات الرابط".](https://help.apple.com/assets/645D5D228BE0233D28263F4B/645D5D248BE0233D28263F53/ar_EG/a164771b90952f39580c229e8d8765f7.png)
إنشاء طلب API
تتطلب نقطة نهاية Typicode أن يتم تنسيق طلب عنوان URL بهذه الطريقة:
https://jsonplaceholder.typicode.com/[RESOURCE]
النص بين القوسين يمثل المصدر الذي ترغب في الوصول إليه. يوفر Typicode العديد من الأمثلة المختلفة لطلبات الاختبار. سيستخدم هذا المثال https://jsonplaceholder.typicode.com/users
لطلب قائمة بالمستخدمين.
في تطبيق الاختصارات
على Mac، أضِف الطلب إلى عنوان URL.
سيعمل الطلب
users
على إنتاج قائمة بالمستخدمين.يمكنك تضييق نطاق البحث عن طريق تحديد مستخدم معين بواسطة المعرف:
https://jsonplaceholder.typicode.com/users/6
. سيؤدي ذلك إلى إرجاع المستخدم صاحب المعرف ٦.تسمح معظم واجهات API بالاستعلامات باستخدام التنسيق التالي:
https://jsonplaceholder.typicode.com/users?username=Bret
. العلامة "؟" تبدأ الاستعلام، الذي يبحث عن العناصر باستخدام أزواج المفتاح/القيمة. في هذا المثال، يبحث الاستعلام?username=Bret
عن مستخدم باسم المستخدم Bret.تحقق من وثائق API لديك لمعرفة عمليات البحث والاستعلامات المدعومة.
تنفيذ طلب API باستخدام إجراء إحضار محتويات عنوان URL
في تطبيق الاختصارات
على Mac، انقر على إظهار المزيد في إجراء إحضار محتويات الرابط.
عندئذٍ تتوفر الخيارات التالية لأنواع طلبات API التي يمكنك إصدارها:
GET
، وهو يتيح لك جلب البيانات.
POST
، وهو يسمح لك بإنشاء بيانات جديدة.
PUT
، وهو يتيح لك تحديث البيانات من خلال استبدالها.
PATCH
، وهو يتيح لك تحديث البيانات من خلال تعديلها.
DELETE
، وهو يسمح لك بإزالة أي كائن محدد في طلب URL.
في هذا المثال، يمكنك استخدام طلب
GET
لجلب البيانات من واجهة API لـ Typicode.الآن بعد أن حصل "عنوان URL" على طلبك وتم إعداد إجراء "إحضار محتويات عنوان URL"
GET
البيانات، أنت جاهز لتنفيذ طلب API.ملاحظة: عند تبديل إجراء "إحضار محتويات عنوان URL" إلى
POST
أوPUT
أوPATCH
، تتم إضافة معامل جديد اسمه طلب النص. يسمح لك "طلب النص" بإرسال JSON أو نموذج أو ملف إلى API كجزء من الطلب. ويتيح لك ذلك إمكانية إدخال البيانات الجديدة يدويًا أو باستخدام متغيرات حتى يمكنك إرسال البيانات إلى API لإنشاء إدخال أو استبداله أو تعديله.لاختبار الاختصار، انقر على
.
تبدو واجهة API، من الوهلة الأولى، كأنها تُرجع الكثير من النص. يتم ترميز هذه البيانات بترميز JSON، وهو اختصار لمصطلح JavaScript Object Notation.
لمعرفة معلومات حول استخدام JSON وللمتابعة مع مثال واجهة API لـ Typicode، انظر مقدمة عن استخدام JSON في الاختصارات على Mac.