Github: واجهة برمجة تطبيقات الرسائل القصيرة بلغة F#

يشرح هذا المقال كيفية تنزيل أحدث مكتبة لواجهة برمجة تطبيقات الرسائل القصيرة بلغة F# من GitHub. ستتعلم كيفية تنزيل تطبيق GitHub Desktop وتسجيل الدخول إليه. كما ستتعلم أيضًا كيفية استنساخ مستودع من الإنترنت. نفترض أنك سبق واستخدمت GitHub وأنك على دراية بـ Visual Studio. سيتم تقديم بعض المعلومات المهمة وتعليمات مفصلة ومرتبة خطوة بخطوة. نأمل أن تجد التعليمات المقدمة مفيدة.

ما هي واجهة برمجة تطبيقات الرسائل القصيرة بلغة F#

واجهة برمجة تطبيقات الرسائل القصيرة (SMS API) هي نوع من واجهات البرمجة التي تتيح للمطورين دمج إرسال الرسائل القصيرة في منصات البرامج الحالية. تتيح لك واجهات برمجة تطبيقات الرسائل القصيرة إرسال أو استقبال الرسائل القصيرة بسرعة وسهولة من خلال أي موقع ويب أو تطبيق. في هذه الحالة، نستخدم واجهة برمجة تطبيقات الرسائل القصيرة بلغة F# من Ozeki لإرسال واستقبال وحذف و جدولة الرسائل النصية مع بوابة Ozeki للرسائل القصيرة.

ما هي بوابة Ozeki للرسائل القصيرة

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

كيف تعمل

تم بناء بنية النظام بالطريقة التالية (الشكل 1). أولاً، يجب على المستخدم تنزيل مكتبة واجهة برمجة تطبيقات الرسائل القصيرة بلغة F# من GitHub. تُعرف هذه العملية أيضًا باسم الاستنساخ. بمجرد اكتمال الاستنساخ، يصبح المستودع جاهزًا للاستخدام. ترسل واجهة برمجة تطبيقات الرسائل القصيرة بلغة F# طلبًا إلى بوابة Ozeki للرسائل القصيرة التي تعمل على جهاز الكمبيوتر أو الجهاز المحمول الخاص بك. ثم تقوم بوابة الرسائل القصيرة بإرسال رسالة SMS وفقًا للطلب. كما تقوم بإرجاع تعليقات في شكل استجابة لك. تستخدم هذه الاستجابة لتأكيد إرسال الرسالة بنجاح.

كيفية تنزيل أحدث مكتبة لواجهة برمجة تطبيقات الرسائل القصيرة بلغة F# من GitHub
الشكل 1 - كيفية تنزيل أحدث مكتبة لواجهة برمجة تطبيقات الرسائل القصيرة بلغة F# من GitHub

كيفية تنزيل واجهة برمجة تطبيقات الرسائل القصيرة بلغة F# من GitHub (خطوات سريعة)

لتنزيل واجهة برمجة تطبيقات الرسائل القصيرة بلغة F# من GitHub:

  1. إنشاء حساب على GitHub
  2. تنزيل GitHub Desktop
  3. تسجيل الدخول إلى GitHub.com
  4. تكوين Git
  5. استنساخ واجهة برمجة تطبيقات الرسائل القصيرة بلغة F# في GitHub Desktop
  6. فتح Ozeki.Libs.Rest.FSharp.sln
  7. بدء مشروع F#
  8. التحقق من الرسائل القصيرة المرسلة في بوابة Ozeki للرسائل القصيرة

تنزيل GitHub Desktop

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

الفيديو 1 - كيفية تنزيل Github Desktop (شرح بالفيديو)

تنزيل GitHub Desktop

للوصول إلى صفحة تنزيل GitHub Desktop، ستحتاج إلى فتح الرابط. هنا يمكنك الحصول على أحدث إصدار من البرنامج. انقر على زر تنزيل لنظام Windows الأرجواني (الشكل 2). سيبدأ هذا عملية التنزيل. انتظر حتى ينتهي المتصفح من العملية للمتابعة.

تنزيل مثبت github desktop
الشكل 2 - تنزيل مثبت Github desktop

تثبيت Github Desktop

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

الفيديو 2 - كيفية تثبيت Github Desktop (شرح بالفيديو)

بدء المثبت

إذا انتهى متصفحك من تنزيل المثبت، ابحث عنه في مجلد التنزيلات على جهاز الكمبيوتر الخاص بك. انقر عليه لبدء عملية التثبيت. سيكون ملفًا من نوع تطبيق باسم GitHubDesktopSetup-x64 (الشكل 3).

بدء مثبت github desktop
الشكل 3 - بدء مثبت Github desktop

صفحة تحميل المثبت

بعد بدء عملية التثبيت، ستظهر لك النافذة المرئية في الشكل 4. هذا يعني أن GitHub Desktop يتم تثبيته حاليًا. لا تحتاج إلى فعل أي شيء هنا. سيتم تشغيل التطبيق بمجرد اختفاء هذه النافذة.

إجراءات التثبيت
الشكل 4 - إجراءات التثبيت

تسجيل الدخول إلى GitHub Desktop

الخطوة التالية هي تسجيل الدخول إلى تطبيق GitHub Desktop. سيطلب ذلك بيانات اعتماد تسجيل الدخول الخاصة بـ حساب مستخدم GitHub الخاص بك. انقر فوق زر تسجيل الدخول إلى GitHub.com للوصول إلى نافذة تسجيل الدخول. إذا لم تستخدم GitHub من قبل، يمكنك إنشاء حساب مستخدم جديد من هذه الصفحة. انقر فوق رابط إنشاء حساب مجاني الموجود أعلى زر تسجيل الدخول. وسينقلك ذلك إلى صفحة إنشاء حساب مستخدم جديد. (الشكل 5)

تسجيل الدخول إلى github
الشكل 5 - تسجيل الدخول إلى github

توفير اسم المستخدم وكلمة المرور

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

تحديد اسم المستخدم وكلمة المرور
الشكل 6 - تحديد اسم المستخدم وكلمة المرور

تكوين Git

ستحدد صفحة تكوين Git المعلومات التي ستظهر كتفاصيل commit. حدد خانة الاختيار استخدام اسم حسابي على GitHub وعنوان البريد الإلكتروني (الشكل 7). هذا يعني أن المعلومات من حساب GitHub الخاص بك ستُستخدم لتحديد الـ commits التي تقوم بإنشائها. ستكون مرئية لأي مستخدم آخر على GitHub. انقر فوق زر إنهاء لتأكيد إعداداتك.

تكوين git
الشكل 7 - تكوين Git

استنساخ مستودع Ozeki.Libs.Rest.Fsharp

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

الفيديو 3 - كيفية استنساخ مستودع Ozeki.Libs.Rest.Fsharp (برنامج تعليمي بالفيديو)

استنساخ مستودع من الإنترنت

لإجراء أي تغييرات على المستودع، تحتاج إلى تنزيل الملفات إلى جهاز الكمبيوتر الخاص بك. هذا يعني أنه يمكنك تعديلها دون اتصال بالإنترنت. من الضروري أن يكون لديك نسخة خاصة بك من الملفات قبل التعديل. في صفحة لنبدأ، يمكنك اختيار إنشاء مستودع تعليمي إذا كنت ترغب في معرفة المزيد عن GitHub Desktop. لتعديل ملفات مستودع Ozeki، اختر خيار استنساخ مستودع من الإنترنت (الشكل 8). سيؤدي ذلك إلى فتح نافذة جديدة تحتاج فيها إلى نسخ عنوان URL للمستودع الذي ترغب في استنساخه.

استنساخ مستودع من الإنترنت
الشكل 8 - استنساخ مستودع من الإنترنت

نسخ رمز URL

الآن تحتاج إلى نسخ عنوان URL للمستودع الذي ترغب في استنساخه. للقيام بذلك، يرجى فتح GitHub في متصفحك وفتح المستودع. لنسخ عنوان URL، لديك خياران ممكنان. الخيار الأول هو البحث عن زر رمز الأخضر الموجود أعلى قائمة الملفات (الشكل 9). انقر فوقه وابحث عن عنوان URL. إذا وجدته، انقر فوق أيقونة النسخ على اليمين. الطريقة الأخرى هي ببساطة نسخ عنوان URL من سطح المكتب. سيؤدي ذلك إلى نفس عنوان URL.

نسخ عنوان URL للرمز
الشكل 9 - نسخ عنوان URL للرمز

استنساخ المستودع

الصق عنوان URL في نموذج استنساخ المستودع. هنا يمكنك تحديد المستودع الذي تريد استنساخه باستخدام مربع النص عنوان URL للمستودع (الشكل 10). في المسار المحلي، تحتاج إلى توفير مسار وصول، حيث سيتم إنشاء مجلد جديد لتخزين الملفات.

لصق عنوان URL واستنساخ المستودع
الشكل 10 - لصق عنوان URL واستنساخ المستودع

العثور على المستودع على جهاز الكمبيوتر الخاص بك

افتح المجلد الذي وفرته لاستنساخ المستودع. للقيام بذلك، انسخ مسار الوصول من النموذج السابق والصقه في شريط أعلى مستكشف الملفات (الشكل 11). اضغط على Enter وسيبدأ تحميل المجلد.

تم استنساخ المستودع
الشكل 11 - تم استنساخ المستودع

كيفية استخدام المستودع

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

الفيديو 4 - كيفية استخدام المستودع (برنامج تعليمي بالفيديو)

تشغيل مشروع Visual Studio

لبدء المشروع حيث يمكنك تعديل الكود، ابحث عن ملف Ozeki.Libs.Rest.FSharp. افتح الملف وسيتم تشغيل Visual Studio. يمكنك تعديل الكود هناك حسب رغبتك. (الشكل 12)

فتح حل واجهة برمجة التطبيقات REST
الشكل 12 - فتح حل واجهة برمجة التطبيقات REST

بدء إرسال رسائل SMS

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

بدء إرسال SMS في الحل
الشكل 13 - بدء إرسال SMS في الحل

الاستجابة من المشروع

الآن ستحصل على الاستجابة من مشروع F#. سترى نتيجة عملية إرسال SMS، رقم هاتف المستلم ونص الرسالة. كما ترى في الشكل 14، ستظهر مطبوعة في نافذة وحدة التحكم.

تم إرسال الرسالة
الشكل 14 - تم إرسال الرسالة

إرسال SMS في Ozeki SMS Gateway

في حالة نجاح عملية الإرسال، يمكنك رؤية الرسالة المرسلة في مجلد "المرسلة" في Ozeki SMS Gateway. للوصول إليه، افتح Ozeki SMS Gateway وابحث عن مجلد "المرسلة" تحت لوحة تفاصيل المستخدمين على اليسار (الشكل 15).

تم إرسال SMS في بوابة SMS
الشكل 15 - تم إرسال SMS في بوابة SMS

ملخص

كان الهدف من المقالة أعلاه وصف خطوات تنزيل واستخدام مشاريع F# من GitHub. باتباع هذه التوجيهات، يمكنك إنشاء الحل في وقت قصير. يمكن استخدام واجهة برمجة تطبيقات F# SMS لإرسال رسائل نصية من جهاز الكمبيوتر الخاص بك بمساعدة Ozeki SMS Gateway. من المهم ذكر أن Ozeki SMS Gateway يعمل في أي دولة ويمكنه إرسال واستقبال SMS عبر اتصالات متنوعة، لذا لا يمكن إيقاف مشاركة البيانات عند الحدود.

لقراءة المزيد عن مواضيع مثل هذه، قم بزيارة صفحة البرامج التعليمية لـ Ozeki حيث يمكنك العثور على معلومات حول حذف في F#.

الآن الشيء الوحيد المتبقي هو تنزيل Ozeki SMS Gateway وبدء العمل!

More information