📌 مستندات پروژه IPPanel API - نسخه PHP

IPPanel API یک رابط برنامه‌نویسی برای ارسال و مدیریت پیامک‌هاست که به توسعه‌دهندگان امکان می‌دهد ارسال پیامک‌های فردی، گروهی، نظیر به نظیر، ارسال پیامک از فایل، دفترچه تلفن، بررسی وضعیت پیامک‌ها و مدیریت حساب را در سیستم خود پیاده‌سازی کنند.

---

🚀 معرفی پروژه

این پروژه پیاده‌سازی کامل IPPanel API در زبان PHP خام است که به توسعه‌دهندگان کمک می‌کند تا با حداقل کدنویسی، پیامک‌های خود را مدیریت و ارسال کنند.

✅ تمامی متدهای مستندات رسمی پیاده‌سازی شده‌اند
✅ نمونه کدهای آماده برای اجرا و تست
✅ پشتیبانی از قابلیت‌های مختلف ارسال پیامک
✅ بهینه‌شده برای استفاده در سیستم‌های مختلف

📢 توجه: اگر قصد دریافت پنل پیامکی رایگان دارید، می‌توانید به سامانه لاین مراجعه کنید یا در تلگرام به من پیام دهید: 09394812277

---

📌 لیست APIهای پشتیبانی‌شده

۱️⃣ ارسال پیامک

سرویس	توضیح
ارسال پیامک عادی	ارسال پیامک به شماره‌های مشخص‌شده.
ارسال پیامک به کدپستی	ارسال پیامک به کاربران در محدوده کدپستی خاص.
ارسال پیامک به محدوده جغرافیایی	ارسال پیامک به افراد بر اساس منطقه، جنسیت و سن.
ارسال پیامک نظیر به نظیر	ارسال پیامک‌های اختصاصی برای شماره‌های مختلف.
ارسال پیامک از فایل CSV	ارسال پیامک به شماره‌های لیست‌شده در فایل CSV.
ارسال پیامک از دفترچه تلفن	ارسال پیامک به شماره‌های موجود در دفترچه تلفن.
ارسال پیامک با الگوی آماده	استفاده از قالب‌های آماده برای ارسال پیامک.
ارسال پیامک با کلیدواژه از فایل	ارسال پیامک با جایگذاری کلیدواژه‌ها در متن.

۲️⃣ بررسی وضعیت پیامک‌ها

سرویس	توضیح
بررسی وضعیت تحویل پیامک	مشاهده وضعیت تحویل پیامک ارسال‌شده.
دریافت لیست پیامک‌های ارسال‌شده	دریافت تاریخچه پیامک‌های ارسالی.
دریافت لیست پیامک‌های دریافتی	مشاهده پیامک‌های دریافت‌شده در پنل.

۳️⃣ مدیریت حساب و اعتبارات

سرویس	توضیح
بررسی اعتبار حساب	مشاهده میزان اعتبار پیامکی حساب.
بررسی هزینه ارسال پیامک	محاسبه هزینه ارسال پیامک از یک شماره خاص.

---

📌 راه‌اندازی و استفاده

۱️⃣ دریافت API Key

برای شروع، باید در سامانه پیامکی لاین ثبت‌نام کنید و کلید API اختصاصی خود را دریافت کنید. این کلید برای احراز هویت تمامی درخواست‌ها مورد نیاز است.

۲️⃣ نصب و اجرای پروژه

ابتدا پروژه را بررسی کنید و فایل مورد نظر را کپی یا کل پروژه رو کلون کنید. سپس مقدار کلید API در فایل‌ها مقدار $apiKey را تنظیم کنید:

$apiKey = "your_api_key_here";

۳️⃣ اجرای کدهای نمونه

برای تست ارسال پیامک، فایل send_sms.php را اجرا کنید:

php send_sms.php

---

📌 نمونه کدهای اجراپذیر

ارسال پیامک عادی

<?php
$apiKey = "your_api_key_here";
$apiUrl = "https://api2.ippanel.com/api/v1/sms/send/webservice/single";

$data = [
    "recipient" => ["+989120000000"],
    "sender" => "+983000505",
    "message" => "این یک پیامک تستی است."
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: AccessKey $apiKey",
    "Content-Type: application/json"
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

---

بررسی وضعیت تحویل پیامک

<?php
$apiKey = "your_api_key_here";
$messageId = "529108936";
$apiUrl = "https://api2.ippanel.com/api/v1/sms/message/show-recipient/message-id/$messageId";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: AccessKey $apiKey",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

---

بررسی اعتبار حساب

<?php
$apiKey = "your_api_key_here";
$apiUrl = "https://api2.ippanel.com/api/v1/sms/accounting/credit/show";

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: AccessKey $apiKey",
    "Content-Type: application/json"
]);

$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

---

📌 پشتیبانی از چندین زبان برنامه‌نویسی

این پروژه ابتدا برای PHP خام توسعه داده شده است، اما به زودی نسخه‌های زیر نیز در گیت‌هاب منتشر خواهند شد:

• Python 🐍
• Java ☕
• Node.js 🚀
• C# 🔷

تمامی آپدیت‌ها از طریق این ریپازیتوری منتشر خواهند شد.

---

📌 سوالات متداول (FAQ)

❓ آیا می‌توان ارسال پیامک را زمان‌بندی کرد؟

بله، در متدهای ارسال پیامک می‌توانید مقدار time را برای تعیین زمان ارسال مشخص کنید.

❓ آیا پیامک‌های ارسال‌شده گزارش وضعیت دارند؟

بله، می‌توانید از API بررسی وضعیت پیامک برای مشاهده وضعیت ارسال استفاده کنید.

❓ چگونه می‌توان پیامک‌های دریافت‌شده را مشاهده کرد؟

از متد دریافت لیست پیامک‌های دریافتی برای مشاهده پیام‌های ورودی استفاده کنید.

---

📌 پشتیبانی و ارتباط

📢 اگر قصد دریافت پنل پیامکی رایگان دارید، می‌توانید به سامانه لاین مراجعه کنید یا در تلگرام به من پیام دهید:
📞 09394812277

🔹 برای مشکلات فنی یا پیشنهادات، لطفاً یک Issue در گیت‌هاب باز کنید.
🔹 اگر به بهبود پروژه علاقه‌مند هستید، Pull Request ارسال کنید!

---

📌 نتیجه‌گیری

IPPanel API یک راهکار پیشرفته برای ارسال و مدیریت پیامک‌هاست. این پروژه با نمونه کدهای آماده، مستندات جامع و قابلیت‌های متنوع، فرآیند ادغام API را ساده کرده است.

🚀 منتظر آپدیت‌های آینده باشید که شامل پشتیبانی از زبان‌های دیگر و قابلیت‌های پیشرفته‌تر خواهد بود! 😊