OpenSkillIndex← back to search
claude-code

Mkhlab saudi-telecom

واجهات شركات الاتصالات السعودية — Saudi telecom developer APIs for SMS, OTP, and payments via STC, Mobily, Zain

install
source · Clone the upstream repo
git clone https://github.com/Moshe-ship/mkhlab
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/Moshe-ship/mkhlab "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/saudi-telecom" ~/.claude/skills/moshe-ship-mkhlab-saudi-telecom-5883bf && rm -rf "$T"
manifest: skills/saudi-telecom/SKILL.md
source content

واجهات شركات الاتصالات السعودية

دليل شامل لواجهات المطورين لدى شركات الاتصالات الثلاث في المملكة العربية السعودية: STC وموبايلي وزين.

مقارنة شاملة

الميزةSTCموبايليزين
البوابةdevelopers.stc.com.sadeveloper.mobily.com.sadeveloper.sa.zain.com
SMS✅✅✅ (SPS)
OTP✅✅✅
الدفع✅✅✅ (TABS)
IoT✅❌❌
بيئة تجريبية✅ مجانية✅✅ Sandbox
البريد الإلكتروني❌✅❌
QR Code❌✅❌

STC — اتصالات السعودية

بوابة المطورين: https://developers.stc.com.sa

الخدمات المتاحة

  • SMS API: إرسال رسائل نصية فردية وجماعية
  • OTP API: إرسال والتحقق من رموز التحقق
  • Identity API: التحقق من هوية المشترك
  • Payment API: الدفع عبر فاتورة STC
  • IoT API: إدارة أجهزة إنترنت الأشياء
  • Network Events API: أحداث الشبكة

الإعداد

  1. سجّل في https://developers.stc.com.sa
  2. أنشئ تطبيقًا واحصل على 
    API Key
  3. بيئة تجريبية مجانية (Sandbox) متاحة مباشرة

إرسال SMS عبر STC

curl -X POST "https://developers.stc.com.sa/api/sms/v1/send" \
  -H "Authorization: Bearer ${STC_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "مرحبًا من تطبيقنا",
    "recipients": ["+966500000000"],
    "sender": "MyApp"
  }'

إرسال OTP عبر STC

curl -X POST "https://developers.stc.com.sa/api/otp/v1/send" \
  -H "Authorization: Bearer ${STC_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "+966500000000",
    "template": "Your code is {otp}"
  }'

موبايلي (Mobily)

بوابة المطورين: https://developer.mobily.com.sa

الخدمات المتاحة

  • OTP API: إرسال والتحقق من رموز التحقق
  • Payment API: الدفع عبر فاتورة موبايلي
  • SMS API: إرسال رسائل نصية
  • Email API: إرسال بريد إلكتروني
  • QR Code API: إنشاء رموز QR

الإعداد

  1. سجّل في https://developer.mobily.com.sa
  2. احصل على 
    App ID
    و 
    App Secret

إرسال SMS عبر موبايلي

curl -X POST "https://developer.mobily.com.sa/api/sms/send" \
  -H "Authorization: Bearer ${MOBILY_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "966550000000",
    "message": "مرحبًا من تطبيقنا",
    "sender": "MyApp"
  }'

إرسال OTP عبر موبايلي

curl -X POST "https://developer.mobily.com.sa/api/otp/send" \
  -H "Authorization: Bearer ${MOBILY_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "966550000000",
    "lang": "ar"
  }'

زين السعودية (Zain KSA)

بوابة المطورين: https://developer.sa.zain.com

الخدمات المتاحة

  • SPS (SMS Premium Service): رسائل نصية مدفوعة
  • TABS (Telecom Application Billing System): الدفع عبر الفاتورة
  • SDP (Service Delivery Platform): منصة تقديم الخدمات

الإعداد

  1. سجّل في https://developer.sa.zain.com
  2. أنشئ تطبيقًا واحصل على بيانات الاعتماد
  3. بيئة Sandbox متاحة للاختبار

إرسال SMS عبر زين

curl -X POST "https://developer.sa.zain.com/api/sps/v1/send" \
  -H "Authorization: Bearer ${ZAIN_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "destinationAddress": "tel:+966590000000",
    "message": "مرحبًا من تطبيقنا",
    "senderAddress": "MyApp"
  }'

الدفع عبر TABS

curl -X POST "https://developer.sa.zain.com/api/tabs/v1/charge" \
  -H "Authorization: Bearer ${ZAIN_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "msisdn": "+966590000000",
    "amount": "5.00",
    "currency": "SAR",
    "description": "اشتراك شهري"
  }'

عرض النتيجة

📱 تم إرسال الرسالة بنجاح
المزود: {{ provider }}
الرقم: {{ recipient }}
معرّف الرسالة: {{ messageId }}
الحالة: {{ status }}

متى تستخدم

استخدم هذه المهارة عندما يسأل المستخدم عن:

  • إرسال رسائل SMS في السعودية
  • خدمات OTP ورموز التحقق عبر الاتصالات
  • واجهات مطوري STC أو موبايلي أو زين
  • الدفع عبر فاتورة الاتصالات (Carrier Billing)
  • بوابات المطورين لشركات الاتصالات السعودية

المراجع