پرش به محتوا
HushSMS

API

رایگان روی هر خط، بدون توجه به مدت زمان. بدون سطح سازمانی، بدون قیمت‌گذاری به ازای هر کاربر، و بدون تماس فروش.

URL پایه

https://api.hushsms.com

احراز هویت

احراز هویت

توکن خط خود را به عنوان اعتبار bearر منتقل کنید. توکن‌ها به یک خط محدود هستند و می‌توانند از پنل چرخانده شوند.

curl https://api.hushsms.com/v1/lines \
  -H "Authorization: Bearer hs_live_..."

مرجع

نقاط پایانی

GET/v1/lines

فهرست خطوط مرتبط با توکن شما. شماره، کشور، مدت و تاریخ انقضا را برمی‌گرداند.

POST/v1/lines

ایجاد خط. بدنه شامل کشور، نوع خط، مدت و استخر می‌شود. یک فاکتور رمزارزی برمی‌گرداند.

GET/v1/lines/{id}/messages

پیام‌های دریافتی برای یک خط، به ترتیب جدیدترین. بدنه پیام‌ها پس از دوره نگهداری حذف می‌شوند.

POST/v1/lines/{id}/messages

ارسال پیامک خروجی. در تمام مدت‌ها گنجانده شده است.

GET/v1/catalog

موجودی زنده کشورها، سازگاری هر سرویس و قیمت‌گذاری فعلی. بدون احراز هویت.

DELETE/v1/lines/{id}

انتشار زودهنگام خط. در مدت‌های ماهانه بازپرداختی وجود ندارد؛ در بالای شش ماه به نسبت محاسبه می‌شود.

فشار

Webhookها

هر پیام ورودی در عرض یک ثانیه پس از رسیدن به نقطه پایانی شما ارسال می‌شود، با امضای HMAC-SHA256.

POST /your-endpoint
X-HushSMS-Signature: sha256=...

{
  "event": "message.received",
  "line_id": "ln_8fQ2...",
  "number": "+44 7700 900123",
  "from":   "+44 7700 900987",
  "body":   "Your code is 481920",
  "received_at": "2026-08-13T09:41:02Z"
}

ماشین‌ها

برای عوامل هوش مصنوعی

کاتالوگ قابل خواندن توسط ماشین در https://hushsms.com/v1/catalog/ قرار دارد. موجودی کشورها، سازگاری هر سرویس و قیمت‌گذاری فعلی را به صورت JSON و بدون احراز هویت برمی‌گرداند.

Open the catalog

موجودی زنده کشورها، سازگاری هر سرویس (از جمله سرویس‌هایی که کار نمی‌کنند)، قیمت‌گذاری فعلی با تمام ضریب‌ها و جدول نگهداری داده‌ها را برمی‌گرداند. کلید لازم نیست، محدودیت نرخ قابل توجهی وجود ندارد و CORS باز است. اگر عاملی می‌سازید که به شماره تلفن نیاز دارد، این نقطه پایانی است که باید بخوانید.

خلاصه متنی ساده از کل سایت در /llms.txt موجود است، با متن کامل در /llms-full.txt.

فهرست به عنوان قرارداد قابل فراخوانی

متن ساده فهرست را خوانا می‌کند، اما آن را قابل فراخوانی نمی‌کند: عاملی که هر کلمه را خوانده باشد هنوز شکل درخواست، فهرست مقادیر کشورها یا فیلدهایی که سرور نادیده می‌گیرد را نمی‌داند، بنابراین می‌تواند شماره‌ای را توصیف کند که نمی‌تواند بخرد. این شکاف جایی است که استراتژی فقط محتوا متوقف می‌شود.

/openapi.json آن را می‌بندد — یک سند OpenAPI 3.1 که سه نقطه پایانی عمومی و بدون احراز هویت را پوشش می‌دهد (خواندن فهرست، ایجاد سفارش و بررسی آن)، با فهرست مقادیر کشور، مدت و استخر که از همان فهرستی تولید شده‌اند که هندلرها بر اساس آن اعتبارسنجی می‌کنند. همچنین در سربرگ سند به عنوان rel="service-desc" اعلام شده است، تا مشتری که به دنبال توضیح سرویس می‌گردد، بدون اینکه به او گفته شود، آن را بیابد.

باز کردن توضیح OpenAPI

منابع

داده‌های طرح شماره‌گذاری در این صفحه — کد شماره‌گیری، طول شماره ملی، پیشوند تنه و محدوده‌های موبایل — از سری E.164 اتحادیه بین‌المللی مخابرات (ITU-T) گرفته شده است. موجودی، قیمت‌گذاری و نرخ موفقیت اندازه‌گیری‌شده متعلق به ماست و به این صورت علامت‌گذاری شده است.

طرح شماره‌گذاری تأیید شد

دریافت شمارهتماس