ارسال پیامک با ⁦.NET⁩

کتابخانه رسمی ⁦.NET⁩ همه اندپوینت‌های پیامک و پیام‌رسان ادسفید را با مدل‌های درخواست و پاسخ نوع‌دار پوشش می‌دهد. نشانی پیش‌فرض آن https://api.adsefid.com است و کلید API را در هدر X-API-KEY می‌فرستد.

adsefid/sdk-dotnet NuGet مستندات کامل API

نصب

پیش‌نیاز:: .NET 8+

$dotnet add package Adsefid.Sdk

ارسال اولین پیامک

کلید API را از متغیر محیطی ADSEFID_API_KEY بخوانید و به کلاینت بدهید. SDK هیچ متغیر محیطی را خودکار نمی‌خواند.

using Adsefid.Sdk;
using Adsefid.Sdk.Sms.Models;

var client = new AdsefidClient(new AdsefidClientOptions
{
    ApiKey = Environment.GetEnvironmentVariable("ADSEFID_API_KEY")!,
});

var result = await client.Sms.SendSingleAsync(new SendSingleSmsRequest
{
    Receptor = "98912xxxxxxx",
    LineNumber = "983000XXX",
    Message = "Hello from adsefid",
});

Console.WriteLine($"message_id={result.MessageId} status={result.Status}");

بررسی امضای وب‌هوک

این تابع هدر X-Atlas-Webhook-Signature و زمان درخواست را بررسی می‌کند و بدنه را به یک رویداد نوع‌دار تبدیل می‌کند. همیشه بدنه خام درخواست را، پیش از هر JSON parse، به آن بدهید.

WebhookVerifier.VerifyAndParse(rawBody, signature, timestamp, secret)

نمونه‌های کامل و قابل اجرا، از جمله گیرنده وب‌هوک، در پوشه examples مخزن قرار دارند.