إرسال رسائل SMS باستخدام Rust: مكتبات API

إرسال رسائل SMS باستخدام Rust: دليل شامل لاستخدام مكتبات API

في عالم التطوير الحديث بلغة Rust، أصبح إرسال رسائل SMS مهمة قياسية للعديد من التطبيقات - بدءًا من أنظمة المصادقة ثنائية العوامل وصولاً إلى إشعارات المستخدمين. في هذه المقالة، سنشرح بالتفصيل كيفية تنفيذ إرسال رسائل SMS باستخدام Rust عبر HTTP API، باستخدام المكتبات والأساليب الشائعة.

لماذا Rust مثالية لتكامل SMS؟

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

المكتبات الأساسية للعمل مع HTTP في Rust

للتفاعل مع مزودي SMS عبر REST API، غالبًا ما تُستخدم الكريتات التالية:

reqwest - عميل HTTP الأكثر شيوعًا لـ Rust. يدعم الطلبات غير المتزامنة والمتزامنة، والعمل مع JSON، والرؤوس، والمصادقة.
serde - مكتبة لتسلسل وإلغاء تسلسل البيانات (ضرورية لمعالجة استجابات JSON من API).
tokio - بيئة تشغيل غير متزامنة، مطلوبة للعمل مع reqwest غير المتزامن.
dotenv - للتخزين الآمن لمفاتيح API والإعدادات.

الهيكل الأساسي للمشروع

لنبدأ بإنشاء مشروع جديد وإضافة التبعيات في Cargo.toml:

[package]name = "sms_sender"version = "0.1.0"edition = "2021"

[dependencies]reqwest = { version = "0.12", features = ["json"] }tokio = { version = "1", features = ["full"] }serde = { version = "1.0", features = ["derive"] }serde_json = "1.0"dotenv = "0.15"

الاتصال بمزود SMS

توفر معظم خدمات SMS (مثل Twilio و Vonage و SMS-Центр) REST API. سننظر في نموذج اتصال عام باستخدام مزود افتراضي كمثال.

لنقم بإنشاء ملف .env لتخزين البيانات الحساسة:

API_KEY=your_api_key_hereAPI_SECRET=your_api_secret_hereSENDER_NAME=MyApp

هياكل البيانات للطلب والاستجابة

سنحدد الأنواع للعمل مع API باستخدام Serde:

use serde::{Deserialize, Serialize};

#[derive(Debug, Serialize)]struct SmsRequest {    api_key: String,    to: String,    message: String,    sender: String,}

#[derive(Debug, Deserialize)]struct SmsResponse {    status: String,    message_id: Option<String>,    error: Option<String>,}

تنفيذ دالة إرسال SMS

الآن سنكتب الدالة الرئيسية لإرسال الرسالة:

use dotenv::dotenv;use std::env;

#[tokio::main]async fn main() -> Result<(), Box<dyn std::error::Error>> {    dotenv().ok();

    let api_key = env::var("API_KEY")?;    let api_secret = env::var("API_SECRET")?;    let sender = env::var("SENDER_NAME")?;

    let client = reqwest::Client::new();

    let sms_request = SmsRequest {        api_key: api_key.clone(),        to: "+79123456789".to_string(),        message: "Привет! Это тестовое SMS из Rust приложения.".to_string(),        sender: sender.clone(),    };

    let response = client        .post("https://api.smsprovider.com/v1/send")        .basic_auth(&api_key, Some(&api_secret))        .json(&sms_request)        .send()        .await?;

    let sms_response: SmsResponse = response.json().await?;

    if sms_response.status == "success" {        println!("SMS отправлено! ID: {:?}", sms_response.message_id);    } else {        eprintln!("Ошибка отправки: {:?}", sms_response.error);    }

    Ok(())}