ارسال پیامک با PHP

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

adsefid/sdk-php Packagist مستندات کامل API

نصب

پیش‌نیاز:: PHP 8.2+

$composer require adsefid/sdk

به یک کلاینت HTTP سازگار با PSR-18 هم نیاز دارد؛ برای نمونه: composer require guzzlehttp/guzzle

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

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

PHP

<?php

require __DIR__ . '/vendor/autoload.php';

use Adsefid\Sdk\AdsefidClient;
use Adsefid\Sdk\ClientConfig;
use Adsefid\Sdk\Models\Sms\SendSingleSmsRequest;

$client = new AdsefidClient(
    new ClientConfig(apiKey: getenv('ADSEFID_API_KEY')),
);

$response = $client->sms->sendSingle(new SendSingleSmsRequest(
    receptor: '98912xxxxxxx',
    lineNumber: '983000XXX',
    message: 'Hello from adsefid',
));

printf("message_id=%s status=%s\n", $response->messageId, $response->status->name);

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

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

PHP

(new WebhookVerifier($secret))->verifyAndParse($rawBody, $signature, $timestamp)

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