مقدمة
يرسل LiSco SMS الرسائل النصية من شرائح SIM في هواتف أندرويد التي تملكها. تستدعي واجهة HTTP واحدة من خادمك، فيرسل هاتفٌ يعمل عليه تطبيق LiSco SMS Gateway الرسالة من شريحته ثم يُبلغ بالنتيجة.
كيف يعمل#
لا ينتظر الهاتف أي اتصال وارد، بل يسحب بنفسه: كل 3 ثوانٍ يرسل طلب HTTPS صادرًا إلى LiSco SMS، فيُبلغ بما جرى للرسائل التي لديه ويأخذ رسائل جديدة. لهذا لا تحتاج إلى رابط عام ولا إلى عنوان IP ثابت ولا إلى إعادة توجيه المنافذ: إذا استطاع الهاتف فتح موقع ويب، استطاع الإرسال عنك.
- شريحتان: يستخدم الهاتف شريحتيه كلتيهما؛ وإذا فشلت إحداهما جرّب الأخرى.
- عدة هواتف: اربط أكثر من هاتف بمساحة العمل، فتنتقل الرسالة التي فشلت على هاتف إلى هاتف آخر.
- أي دولة وأي شبكة: تخرج الرسائل كرسائل SMS عادية من شرائحك.
رحلة الرسالة#
- يستدعي خادمك
POST /v1/messages، فتُحفظ الرسالة بالحالةpendingويعود إليك معرّفهاidفورًا. - خلال 3 ثوانٍ تقريبًا يسحبها هاتف مربوط: الحالة
claimed. - يرسلها الهاتف من إحدى شريحتيه: الحالة
sent. - إذا أعادت الشبكة تقرير تسليم: الحالة
delivered. - في كل خطوة يمكنك قراءة الرسالة عبر
GET /v1/messages/{id}، أو استقبال التغيير عبر Webhook.
إذا لم يرسلها أي هاتف قبل انتهاء صلاحيتها أصبحت expired، وإذا فشلت كل المحاولات أصبحت failed. راجع حالات الرسائل.
عنوان الأساس#
تقع جميع نقاط النهاية تحت عنوان أساس واحد، وتستخدمه الأمثلة في هذا التوثيق:
https://sms.liscosolutions.com/v1
الطلبات والردود بصيغة JSON (Content-Type: application/json)، والأوقات بصيغة ISO 8601 بتوقيت UTC، ويحتاج كل طلب إلى مفتاح API.
OpenAPI#
الواجهة كلها موصوفة في مستند OpenAPI 3.1. استورده في Postman أو Insomnia أو في مولّد عملاء:
curl "https://sms.liscosolutions.com/v1/openapi.json"const res = await fetch("https://sms.liscosolutions.com/v1/openapi.json", {
});
console.log(res.status, await res.json());<?php
$ch = curl_init("https://sms.liscosolutions.com/v1/openapi.json");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
]);
$body = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
print_r([$status, $body]);import requests
res = requests.get(
"https://sms.liscosolutions.com/v1/openapi.json",
)
print(res.status_code, res.json()){
"openapi": "3.1.0",
"info": {
"title": "LiSco SMS API",
"version": "1.0.0"
}
}/v1/openapi.json.