API
مجاني على كل خط، بغض النظر عن المدة. لا طبقة مؤسسية، لا تسعير لكل مقعد، ولا مكالمة مبيعات.
عنوان URL الأساسي
https://api.hushsms.com
المصادقة
المصادقة
مرّر رمز خطك كبيانات اعتماد حامل. الرموز مقيدة بخط واحد ويمكن تدويرها من اللوحة.
curl https://api.hushsms.com/v1/lines \ -H "Authorization: Bearer hs_live_..."
مرجع
النقاط النهائية
/v1/linesسرد الخطوط المرتبطة برمزك. يُرجع الرقم والدولة والمدة وتاريخ الانتهاء.
/v1/linesتوفير خط. يأخذ الجسم الدولة ونوع الخط والمدة والمجموعة. يُرجع فاتورة بالعملة المشفرة.
/v1/lines/{id}/messagesالرسائل الواردة لخط ما، الأحدث أولاً. تُحذف الرسائل بعد فترة الاحتفاظ.
/v1/lines/{id}/messagesإرسال رسالة SMS صادرة. متضمن في كل المدد.
/v1/catalogتوفر الدول مباشر، وتوافق كل خدمة، والأسعار الحالية. بدون مصادقة.
/v1/lines/{id}إصدار خط مبكرًا. لا استرداد في المدد الشهرية؛ استرداد نسبي فوق ستة أشهر.
دفع
خطافات الويب
كل رسالة واردة تُرسل بواسطة POST إلى نقطة نهايتك خلال ثانية من الوصول، موقعة بـ 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، دون مصادقة.
يُرجع توفر الدول مباشرًا، وتوافق كل خدمة بما فيها الخدمات التي لا تعمل، والأسعار الحالية مع كل المضاعفات، وجدول الاحتفاظ بالبيانات. لا مفتاح، ولا حد معدل يستحق الذكر، وCORS مفتوح. إذا كنت تبني وكيلًا يحتاج رقم هاتف، فهذه هي نقطة النهاية التي يجب قراءتها.
ملخص نصي بسيط للموقع بأكمله موجود في /llms.txt، مع النص الكامل في /llms-full.txt.
الكتالوج كعقد قابل للاستدعاء
النص العادي يجعل الكتالوج قابلاً للقراءة، لكنه لا يجعله قابلاً للاستدعاء: الوكيل الذي قرأ كل كلمة ما زال لا يعرف شكل الطلب، أو تعداد معرفات الدول، أو الحقول التي يتجاهلها الخادم، لذا يمكنه وصف رقم لا يمكنه شراءه. هذه الفجوة هي حيث تتوقف استراتيجية المحتوى فقط.
/openapi.json يسد هذه الفجوة — وثيقة OpenAPI 3.1 تغطي نقاط النهاية الثلاث العامة غير المصادق عليها (قراءة الكتالوج، إنشاء طلب، استطلاعه)، مع توليد تعدادات الدول والمدد والمجموعات من نفس الكتالوج الذي تتحقق منه المعالجات. كما أنها معلنة في رأس المستند كـrel="service-desc"، بحيث يجد العميل الذي يبحث عن وصف خدمة واحدًا دون أن يُقال له أين.
المصادر
بيانات خطة الترقيم في هذه الصفحة — رمز الاتصال، طول الرقم الوطني، بادئة الشبكة، ونطاقات الجوال — مأخوذة من سلسلة ITU-T E.164. المخزون والأسعار ومعدلات النجاح المقاسة هي بياناتنا الخاصة وتُشار إليها على هذا النحو.
- ITU-T Recommendation E.164 — The international public telecommunication numbering plan · International Telecommunication Unionرموز الاتصال بالدول، وأطوال الأرقام الوطنية المهمة، وبنية الأرقام
- ITU-T E.164 national numbering plans (Operational Bulletin annex) · International Telecommunication Unionخطط الترقيم لكل دولة، ونطاقات الجوال، وبادئات الخطوط الرئيسية
تم التحقق من خطة الترقيم