saudi-telecom

name	saudi-telecom
description	واجهات شركات الاتصالات السعودية -- STC وموبايلي وزين للرسائل والتحقق والدفع
version	1.0.0
author	Mousa Abu Mazin
license	MIT
platforms	["linux","macos"]
prerequisites	{"commands":["curl"],"env_vars":["STC_API_KEY","MOBILY_TOKEN","ZAIN_TOKEN"]}
metadata	{"hermes":{"tags":["saudi","telecom","stc","mobily","zain","sms","otp","carrier-billing"]}}

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

تنبيه: استخدم بيانات اختبار فقط. لا تستخدم هويات وطنية حقيقية أو توكنات دفع حية أثناء التجربة. استخدم بيئة الاختبار (sandbox) دائماً. احذف السجلات بعد الانتهاء.

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

---

مقارنة شاملة

الميزة	STC	موبايلي	زين
البوابة	developers.stc.com.sa	developer.mobily.com.sa	developer.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": ["[phone]"],
    "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": "[phone]",
    "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:[phone]",
    "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": "[phone]",
    "amount": "5.00",
    "currency": "SAR",
    "description": "اشتراك شهري"
  }'

---

عرض النتيجة

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

---

متى تستخدم

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

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

---

المراجع

• STC Developers: https://developers.stc.com.sa
• Mobily Developer: https://developer.mobily.com.sa
• Zain KSA Developer: https://developer.sa.zain.com