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 (خطوات سريعة)
لتنزيل واجهة برمجة تطبيقات الرسائل القصيرة بلغة F# من GitHub:
- إنشاء حساب على GitHub
- تنزيل GitHub Desktop
- تسجيل الدخول إلى GitHub.com
- تكوين Git
- استنساخ واجهة برمجة تطبيقات الرسائل القصيرة بلغة F# في GitHub Desktop
- فتح Ozeki.Libs.Rest.FSharp.sln
- بدء مشروع F#
- التحقق من الرسائل القصيرة المرسلة في بوابة Ozeki للرسائل القصيرة
تنزيل GitHub Desktop
في هذا الفيديو، ستتعلم كيفية تنزيل تطبيق GitHub Desktop. سيبدأ الفيديو بفتح صفحة تنزيل GitHub Desktop وسيأخذك حتى الحصول على المثبت على جهاز الكمبيوتر الخاص بك. ستتعلم أي صفحة تزورها للحصول على ملف المثبت. مدة الفيديو دقيقة واحدة فقط، وستتعلم كل المعلومات التي تحتاجها لإكمال عملية التنزيل.
تنزيل GitHub Desktop
للوصول إلى صفحة تنزيل GitHub Desktop، ستحتاج إلى فتح الرابط. هنا يمكنك الحصول على أحدث إصدار من البرنامج. انقر على زر تنزيل لنظام Windows الأرجواني (الشكل 2). سيبدأ هذا عملية التنزيل. انتظر حتى ينتهي المتصفح من العملية للمتابعة.
تثبيت Github Desktop
في هذا الفيديو، سنوضح لك كيفية بدء عملية التثبيت لـ GitHub Desktop. سيبدأ بتشغيل المثبت وسيأخذك حتى الحصول على برنامج يعمل على جهاز الكمبيوتر الخاص بك. ستتعلم أيضًا كيفية تسجيل الدخول إلى تطبيق GitHub Desktop وكيفية تكوين التطبيق. مدة الفيديو دقيقة واحدة فقط وهو مفصل للغاية. لن تواجه أي مشكلة في فهم الخطوات.
بدء المثبت
إذا انتهى متصفحك من تنزيل المثبت، ابحث عنه في مجلد التنزيلات على جهاز الكمبيوتر الخاص بك. انقر عليه لبدء عملية التثبيت. سيكون ملفًا من نوع تطبيق باسم GitHubDesktopSetup-x64 (الشكل 3).
صفحة تحميل المثبت
بعد بدء عملية التثبيت، ستظهر لك النافذة المرئية في الشكل 4. هذا يعني أن GitHub Desktop يتم تثبيته حاليًا. لا تحتاج إلى فعل أي شيء هنا. سيتم تشغيل التطبيق بمجرد اختفاء هذه النافذة.
تسجيل الدخول إلى GitHub Desktop
الخطوة التالية هي تسجيل الدخول إلى تطبيق GitHub Desktop. سيطلب ذلك بيانات اعتماد تسجيل الدخول الخاصة بـ حساب مستخدم GitHub الخاص بك. انقر فوق زر تسجيل الدخول إلى GitHub.com للوصول إلى نافذة تسجيل الدخول. إذا لم تستخدم GitHub من قبل، يمكنك إنشاء حساب مستخدم جديد من هذه الصفحة. انقر فوق رابط إنشاء حساب مجاني الموجود أعلى زر تسجيل الدخول. وسينقلك ذلك إلى صفحة إنشاء حساب مستخدم جديد. (الشكل 5)
توفير اسم المستخدم وكلمة المرور
سيفتح الزر نافذة متصفح جديدة، حيث تحتاج إلى تسجيل الدخول (الشكل 6). في هذه الصفحة، تحتاج إلى استخدام اسم المستخدم وكلمة المرور لحساب GitHub الخاص بك. اكتب كلاهما في مربع النص الصحيح وانقر فوق زر تسجيل الدخول للمتابعة إلى الخطوة التالية.
تكوين Git
ستحدد صفحة تكوين Git المعلومات التي ستظهر كتفاصيل commit. حدد خانة الاختيار استخدام اسم حسابي على GitHub وعنوان البريد الإلكتروني (الشكل 7). هذا يعني أن المعلومات من حساب GitHub الخاص بك ستُستخدم لتحديد الـ commits التي تقوم بإنشائها. ستكون مرئية لأي مستخدم آخر على GitHub. انقر فوق زر إنهاء لتأكيد إعداداتك.
استنساخ مستودع Ozeki.Libs.Rest.Fsharp
في الفيديو التالي، سترى كيفية استنساخ مستودع GitHub. سيبدأ من الصفحة الرئيسية لتطبيق GitHub Desktop وسينقلك مباشرة إلى وجود المستودع المستنسخ على جهاز الكمبيوتر الخاص بك. يمكنك معرفة عنوان URL الذي يجب نسخه ولصقه في تطبيق GitHub Desktop. أما الباقي فسيتكفل به GitHub Desktop. طول الفيديو 38 ثانية، لكنه يحتوي على كل الخطوات بالتفصيل. لن تواجه أي مشكلة في متابعته.
استنساخ مستودع من الإنترنت
لإجراء أي تغييرات على المستودع، تحتاج إلى تنزيل الملفات إلى جهاز الكمبيوتر الخاص بك. هذا يعني أنه يمكنك تعديلها دون اتصال بالإنترنت. من الضروري أن يكون لديك نسخة خاصة بك من الملفات قبل التعديل. في صفحة لنبدأ، يمكنك اختيار إنشاء مستودع تعليمي إذا كنت ترغب في معرفة المزيد عن GitHub Desktop. لتعديل ملفات مستودع Ozeki، اختر خيار استنساخ مستودع من الإنترنت (الشكل 8). سيؤدي ذلك إلى فتح نافذة جديدة تحتاج فيها إلى نسخ عنوان URL للمستودع الذي ترغب في استنساخه.
نسخ رمز URL
الآن تحتاج إلى نسخ عنوان URL للمستودع الذي ترغب في استنساخه. للقيام بذلك، يرجى فتح GitHub في متصفحك وفتح المستودع. لنسخ عنوان URL، لديك خياران ممكنان. الخيار الأول هو البحث عن زر رمز الأخضر الموجود أعلى قائمة الملفات (الشكل 9). انقر فوقه وابحث عن عنوان URL. إذا وجدته، انقر فوق أيقونة النسخ على اليمين. الطريقة الأخرى هي ببساطة نسخ عنوان URL من سطح المكتب. سيؤدي ذلك إلى نفس عنوان URL.
استنساخ المستودع
الصق عنوان URL في نموذج استنساخ المستودع. هنا يمكنك تحديد المستودع الذي تريد استنساخه باستخدام مربع النص عنوان URL للمستودع (الشكل 10). في المسار المحلي، تحتاج إلى توفير مسار وصول، حيث سيتم إنشاء مجلد جديد لتخزين الملفات.
العثور على المستودع على جهاز الكمبيوتر الخاص بك
افتح المجلد الذي وفرته لاستنساخ المستودع. للقيام بذلك، انسخ مسار الوصول من النموذج السابق والصقه في شريط أعلى مستكشف الملفات (الشكل 11). اضغط على Enter وسيبدأ تحميل المجلد.
كيفية استخدام المستودع
في الفيديو الأخير، ستتعرف على كيفية استخدام المستودع الذي قمت باستنساخه للتو إلى جهاز الكمبيوتر الخاص بك. سيبدأ الفيديو بالمجلد المفتوح حيث توجد السجلات المستنسخة. سينتهي بمشروع إرسال الرسائل القصيرة الذي تم تشغيله بنجاح. ستتعرف على كيفية إطلاق مشروع وكيفية التحقق من سجله. طول الفيديو دقيقة و31 ثانية فقط وهو يتضمن كل ما تحتاج إلى القيام به للحصول على مشروع يعمل.
تشغيل مشروع Visual Studio
لبدء المشروع حيث يمكنك تعديل الكود، ابحث عن ملف Ozeki.Libs.Rest.FSharp. افتح الملف وسيتم تشغيل Visual Studio. يمكنك تعديل الكود هناك حسب رغبتك. (الشكل 12)
بدء إرسال رسائل SMS
انقر على زر إرسال SMS الموجود في أعلى واجهة التطبيق الرسومية (الشكل 13). سيبدأ هذا تشغيل السكربت ويمكنك البدء في إرسال رسائل SMS. في لوحة محرر الكود، يمكنك إجراء تغييرات على الكود لتشغيله مخصصًا.
الاستجابة من المشروع
الآن ستحصل على الاستجابة من مشروع F#. سترى نتيجة عملية إرسال SMS، رقم هاتف المستلم ونص الرسالة. كما ترى في الشكل 14، ستظهر مطبوعة في نافذة وحدة التحكم.
إرسال SMS في Ozeki SMS Gateway
في حالة نجاح عملية الإرسال، يمكنك رؤية الرسالة المرسلة في مجلد "المرسلة" في Ozeki SMS Gateway. للوصول إليه، افتح Ozeki SMS Gateway وابحث عن مجلد "المرسلة" تحت لوحة تفاصيل المستخدمين على اليسار (الشكل 15).
ملخص
كان الهدف من المقالة أعلاه وصف خطوات تنزيل واستخدام مشاريع F# من GitHub. باتباع هذه التوجيهات، يمكنك إنشاء الحل في وقت قصير. يمكن استخدام واجهة برمجة تطبيقات F# SMS لإرسال رسائل نصية من جهاز الكمبيوتر الخاص بك بمساعدة Ozeki SMS Gateway. من المهم ذكر أن Ozeki SMS Gateway يعمل في أي دولة ويمكنه إرسال واستقبال SMS عبر اتصالات متنوعة، لذا لا يمكن إيقاف مشاركة البيانات عند الحدود.
لقراءة المزيد عن مواضيع مثل هذه، قم بزيارة صفحة البرامج التعليمية لـ Ozeki حيث يمكنك العثور على معلومات حول حذف في F#.
الآن الشيء الوحيد المتبقي هو تنزيل Ozeki SMS Gateway وبدء العمل!
More information
- كيفية إرسال SMS من F#
- كيفية إرسال عدة رسائل SMS من F#
- جدولة SMS باستخدام F# مع واجهة برمجة التطبيقات REST (HTTP) (عينة كود)
- استقبال SMS باستخدام F# مع واجهة برمجة التطبيقات REST (HTTP) (عينة كود)
- حذف SMS باستخدام F# مع واجهة برمجة التطبيقات REST (HTTP) (عينة كود)
- Github: F# SMS API
- مكتبة NuGet لإرسال SMS باستخدام F#