تخطَّ إلى المحتوى

الانتقال إلى الإنتاج

تكاملك يعمل بمفتاح sf_test_. الانتقال إلى الإنتاج يعني شرائح حقيقية ومستلمين حقيقيين وتكاليف حقيقية على خطة شركة الاتصالات. راجع هذه القائمة قبل التحويل.

  1. اقرن هاتفي Android على الأقل، كي لا تتوقف حركتك إذا انقطع أحدهما (إقران هاتف).
  2. ضعهما في مجموعة وأرسل مع poolId لتحصل على التناوب والتحويل عند التعطل.
  3. أبقهما على الشاحن، وعلى Wi-Fi أو بإشارة جيدة، واستثنِ التطبيق من تحسين البطارية (البطارية).
  4. راجع خطة كل شريحة: رصيد الرسائل، والحدود اليومية لشركة الاتصالات، والإرسال الدولي إن احتجته. اضبط dailyLimit لكل شريحة عبر PATCH /v1/devices/:id/sims/:simId لتبقى دون حدود شركة الاتصالات.
  5. اختر الشريحة الافتراضية عبر POST /v1/devices/:id/sims/:simId/default، أو من الأجهزة.
  1. أنشئ مفتاحا مع إنتاج · رسائل حقيقية في الوضع، وبالصلاحيات التي تحتاجها الخدمة فقط (المصادقة).
  2. أضف قائمة عناوين IP المسموحة إن كانت لخوادمك عناوين ثابتة، وتاريخ انتهاء إن كانت عملية التدوير لديك تسمح.
  3. ضع المفتاح في مدير الأسرار كقيمة جديدة، مثل SMSFABRIC_API_KEY. احتفظ بمفتاح الاختبار لبيئة التجهيز والتكامل المستمر.

لا يتغير شيء آخر في شيفرتك: الرابط الأساسي ومحتوى الطلبات والاستجابات كما هي.

نافذة طرفيّة
# A live smoke test to your own number. Check that it arrives.
curl https://api.smsfabric.com/v1/messages \
-H "X-Api-Key: $SMSFABRIC_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: go-live-smoke-1" \
-d '{"to": "+201001234567", "body": "SMSFabric live test"}'
  • كل إرسال يحمل Idempotency-Key مشتقا من بياناتك (منع التكرار).
  • تُعاد محاولة أخطاء الشبكة و429 و5xx بفواصل متزايدة، ولا تُعاد 4xx (الأخطاء).
  • تتعامل شيفرتك مع blocked في استجابة الإرسال ومع failed لاحقا.
  • تتحقق نقطة نهاية webhook من التوقيع على المحتوى الخام وتزيل التكرار بالاعتماد على SMSFabric-Event-Id (Webhooks).
  • ترد نقطة نهاية webhook خلال 10 ثوان ومشتركة فقط في الأحداث التي تستخدمها.
  • تُحفظ أرقام الهواتف وتُرسل بصيغة E.164.
  • لا تحتوي السجلات على مفتاح API ولا نصوص الرسائل ولا أرقام الهواتف كاملة.
  • وافق المستلمون على تلقي رسائلك. سجّل ذلك في consent لكل جهة اتصال.
  • تذكر الرسائل التسويقية طريقة إلغاء الاشتراك («أرسل STOP لإلغاء الاشتراك»). تحترم SMSFabric الكلمتين STOP وSTART تلقائيا (استقبال الرسائل).
  • ساعات الهدوء ونافذة الإرسال لديك توافق القواعد المحلية.
  • الدول المسموحة في خدمة التحقق مقتصرة على التي تخدمها.
  • شروط شرائحك تسمح بنوع الحركة التي ترسلها وحجمها.
  • تابع نظرة عامة في البوابة للرسائل الفاشلة والهواتف المنقطعة.
  • اشترك في device.offline ونبّه أحدا عند انقطاع هاتف.
  • راجع طلبات webhook الفاشلة في المطوّرون ← Webhooks، وأعد إرسالها بعد أي انقطاع.
  • راجع سجل التدقيق لإنشاء المفاتيح وتغيير الأدوار.
  • دوّر مفتاح API دوريا عبر POST /v1/api-keys/:id/rotate: يبقى السر القديم صالحا 24 ساعة ريثما تنشر الجديد.