طلب أول API في الاختصارات
لطلب أول API لك، يمكنك إنشاء URL الذي يشير إلى "نقطة نهاية" API التي تريد الاتصال بها، ثم تمرير هذا الـ URL إلى إجراء "إحضار محتويات عنوان URL". عند تشغيل الاختصار، يُصدِر هذا الإجراء طلب API.
إنشاء طلب API
تتطلب نقطة نهاية توقعات Dark Sky أن يتم تنسيق طلب URL كما يلي:
https://api.darksky.net/forecast/[YOUR_SECRET_KEY]/[LAT],[LONG]
تتم تعبئة النص الذي بين الأقواس بمفتاح API والموقع المراد معرفة بيانات التوقعات الخاصة به.
في تطبيق الاختصارات، ضع مفتاح API من Dark Sky في إجراء النص الأول، والذي يتم تمريره إلى إجراء عنوان URL على أنه متغير. تم تعيين قيمتي
LATوLONGمسبقًا على٣٧,٨٢٦٧و-١٢٢,٤٢٣٣، وهماالإحداثيان الخاصان بجزيرة ألكتراز في سان فرانسيسكو. (يمكنك تغيير هاتين القيمتين إلى موقع مختلف).جرِّب استخدام إجراء "إحضار الموقع الحالي" ووضعه على أنه متغير Magic معيّن على خط العرض وخط الطول في إجراء "عنوان URL" لإحضار بيانات الطقس المحلي كلما تم تشغيل الاختصار.
تنفيذ طلب API باستخدام إجراء إحضار محتويات عنوان URL
في محرر الاختصارات بتطبيق الاختصارات، قم بتعيين "إحضار محتويات عنوان URL" على "متقدم".
عندئذٍ تتوفر الخيارات التالية لأنواع طلبات API التي يمكنك إصدارها:
إحضار، وهو يسمح لك بجلب البيانات من API لقراءتها.نشر، وهو يسمح لك بإنشاء بيانات جديدة.وضعوتصحيح، وهما يسمحان لك بتحديث البيانات من خلال استبدالها أو تعديلها، على التوالي.حذف، وهو يسمح لك بإزالة أي كائن محدد في طلب URL.
في هذا المثال، يمكنك استخدام طلب
إحضارلجلب البيانات من واجهة API لـ Dark Sky API.الآن بعد أن حصل "عنوان URL" على طلبك وتم إعداد إجراء "إحضار محتويات عنوان URL"
لإحضارالبيانات، أنت جاهز لتنفيذ طلب API.ملاحظة: عند تبديل إجراء "إحضار محتويات عنوان URL" إلى
نشرأووضعأوتصحيح، تتم إضافة معامل جديد اسمه طلب النص. يسمح لك "طلب النص" بإرسال JSON أو نموذج أو ملف إلى API كجزء من الطلب. ويتيح لك ذلك إمكانية إدخال البيانات الجديدة يدويًا أو باستخدام متغيرات حتى يمكنك إرسال البيانات إلى API لإنشاء إدخال أو استبداله أو تعديله.اضغط على
لاختبار الاختصار (يسمح لك إجراء "معاينة سريعة" في الاختصار بمعاينة البيانات التي تُرجعها واجهة API).
تهانينا! لقد نفّذت أول طلب API لك باستخدام الاختصارات.
تبدو واجهة API من الوهلة الأولى كأنها تُرجع الكثير من النص المنسق بشكل غريب. ولكن عند التدقيق فيها، يمكنك ملاحظة أن النص يحتوي على معلومات لتوقعات الطقس. بيانات الطقس هذه بترميز JSON، وهو اختصار لـ JavaScript Object Notation.
لمعرفة معلومات حول استخدام JSON وللمتابعة مع مثال واجهة API لـ Dark Sky، انظر حول استخدام JSON في الاختصارات.