الانتقال إلى الإنتاج
تكاملك يعمل بمفتاح sf_test_. الانتقال إلى الإنتاج يعني شرائح حقيقية ومستلمين حقيقيين وتكاليف حقيقية على خطة شركة الاتصالات. راجع هذه القائمة قبل التحويل.
1. جهّز الهواتف
Section titled “1. جهّز الهواتف”- اقرن هاتفي Android على الأقل، كي لا تتوقف حركتك إذا انقطع أحدهما (إقران هاتف).
- ضعهما في مجموعة وأرسل مع
poolIdلتحصل على التناوب والتحويل عند التعطل. - أبقهما على الشاحن، وعلى Wi-Fi أو بإشارة جيدة، واستثنِ التطبيق من تحسين البطارية (البطارية).
- راجع خطة كل شريحة: رصيد الرسائل، والحدود اليومية لشركة الاتصالات، والإرسال الدولي إن احتجته. اضبط
dailyLimitلكل شريحة عبرPATCH /v1/devices/:id/sims/:simIdلتبقى دون حدود شركة الاتصالات. - اختر الشريحة الافتراضية عبر
POST /v1/devices/:id/sims/:simId/default، أو من الأجهزة.
2. أنشئ مفتاحا حقيقيا
Section titled “2. أنشئ مفتاحا حقيقيا”- أنشئ مفتاحا مع إنتاج · رسائل حقيقية في الوضع، وبالصلاحيات التي تحتاجها الخدمة فقط (المصادقة).
- أضف قائمة عناوين IP المسموحة إن كانت لخوادمك عناوين ثابتة، وتاريخ انتهاء إن كانت عملية التدوير لديك تسمح.
- ضع المفتاح في مدير الأسرار كقيمة جديدة، مثل
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"}'import { SMSFabric } from '@smsfabric/sdk';
const sf = new SMSFabric({ apiKey: process.env.SMSFABRIC_API_KEY });
const [message] = await sf.messages.send( { to: '+201001234567', body: 'SMSFabric live test' }, { idempotencyKey: 'go-live-smoke-1' },);console.log(message.id, message.status);import osimport requests
res = requests.post( "https://api.smsfabric.com/v1/messages", headers={"X-Api-Key": os.environ["SMSFABRIC_API_KEY"], "Idempotency-Key": "go-live-smoke-1"}, json={"to": "+201001234567", "body": "SMSFabric live test"}, timeout=30,)res.raise_for_status()print(res.json()["data"][0]["id"])<?php$ch = curl_init('https://api.smsfabric.com/v1/messages');curl_setopt_array($ch, [ CURLOPT_POST => true, CURLOPT_POSTFIELDS => json_encode(['to' => '+201001234567', 'body' => 'SMSFabric live test']), CURLOPT_HTTPHEADER => [ 'X-Api-Key: ' . getenv('SMSFABRIC_API_KEY'), 'Content-Type: application/json', 'Idempotency-Key: go-live-smoke-1', ], CURLOPT_RETURNTRANSFER => true,]);echo curl_exec($ch) . "\n";3. أحكم التكامل
Section titled “3. أحكم التكامل”- كل إرسال يحمل
Idempotency-Keyمشتقا من بياناتك (منع التكرار). - تُعاد محاولة أخطاء الشبكة و
429و5xxبفواصل متزايدة، ولا تُعاد4xx(الأخطاء). - تتعامل شيفرتك مع
blockedفي استجابة الإرسال ومعfailedلاحقا. - تتحقق نقطة نهاية webhook من التوقيع على المحتوى الخام وتزيل التكرار بالاعتماد على
SMSFabric-Event-Id(Webhooks). - ترد نقطة نهاية webhook خلال 10 ثوان ومشتركة فقط في الأحداث التي تستخدمها.
- تُحفظ أرقام الهواتف وتُرسل بصيغة E.164.
- لا تحتوي السجلات على مفتاح API ولا نصوص الرسائل ولا أرقام الهواتف كاملة.
4. الامتثال
Section titled “4. الامتثال”- وافق المستلمون على تلقي رسائلك. سجّل ذلك في
consentلكل جهة اتصال. - تذكر الرسائل التسويقية طريقة إلغاء الاشتراك («أرسل STOP لإلغاء الاشتراك»). تحترم SMSFabric الكلمتين STOP وSTART تلقائيا (استقبال الرسائل).
- ساعات الهدوء ونافذة الإرسال لديك توافق القواعد المحلية.
- الدول المسموحة في خدمة التحقق مقتصرة على التي تخدمها.
- شروط شرائحك تسمح بنوع الحركة التي ترسلها وحجمها.
5. راقب
Section titled “5. راقب”- تابع نظرة عامة في البوابة للرسائل الفاشلة والهواتف المنقطعة.
- اشترك في
device.offlineونبّه أحدا عند انقطاع هاتف. - راجع طلبات webhook الفاشلة في المطوّرون ← Webhooks، وأعد إرسالها بعد أي انقطاع.
- راجع سجل التدقيق لإنشاء المفاتيح وتغيير الأدوار.
- دوّر مفتاح API دوريا عبر
POST /v1/api-keys/:id/rotate: يبقى السر القديم صالحا 24 ساعة ريثما تنشر الجديد.