ارسال پیامک با Node.js

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

adsefid/sdk-js npm مستندات کامل API

نصب

پیش‌نیاز:: Node.js 22+ · JS/TS

$npm install @adsefid/sdk

فقط برای سمت سرور است و به دلیل نگه‌داری و ارسال کلید API محرمانه شما هرگز نباید در سمت کلاینت (مرورگر) استفاده شود.

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

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

TypeScript

import { AdsefidClient } from "@adsefid/sdk";

const client = new AdsefidClient({ apiKey: process.env.ADSEFID_API_KEY! });

const result = await client.sms.sendSingle({
  receptor: "98912xxxxxxx",
  line_number: "983000XXX",
  message: "Hello from adsefid",
});

console.log(result.message_id, result.status);

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

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

TypeScript

verifyAndParseWebhook({ rawBody, signatureHeader, timestampHeader, secret })

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