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

Postman وInsomnia

جرّب الواجهة البرمجية من Postman أو Insomnia دون كتابة شيفرة. تغطي المجموعتان الطلبات نفسها: إرسال رسالة وقراءة سجلها الزمني، ثم مجموعات الأجهزة وعمليات التحقق وجهات الاتصال والقوالب والحملات وخطافات الويب والقائمة السوداء وباقتك.

22 طلبًا جاهزًا بالترتيب الذي تجربها به، من أول إرسال إلى الحملات وخطافات الويب وباقتك.

تُنشأ الملفات مع كل بناء للوثائق، ويُتحقق من كل طلب فيها مقابل عقد الواجهة البرمجية، فتطابق هذا المرجع.

  • اربط هاتفا، أو استخدم مفتاحا تجريبيا. المفتاح الذي يبدأ بـ sf_test_ يرسل عبر بيئة الاختبار، فلا تخرج أي رسالة من أي هاتف.
  • أنشئ مفتاح API بالصلاحيات التي تحتاجها المجلدات التي ستشغلها. تكفي messages:send وmessages:read للمجلد الأول.
  1. اضغط Import وأفلت الملف smsfabric.postman_collection.json.

  2. افتح المجموعة، وانتقل إلى Variables، واضبط apiKey في عمود Current value. تبقى القيم الحالية على جهازك، أما القيم الأولية فتُزامن مع مساحة عملك.

  3. شغّل Messages › Send a message. الرد 201 مع status: "queued" يعني أن الرسالة في طريقها إلى هاتف.

يرسل كل طلب X-Api-Key: {{apiKey}}. وتضيف طلبات الإرسال Idempotency-Key: {{$guid}}، فلا تؤدي إعادة المحاولة بالمفتاح نفسه إلى إرسال مرتين (منع التكرار).

بعد طلب إنشاء، يحفظ Postman المعرف الجديد للطلبات التالية:

المتغير يضبطه
messageId Send a message، وSend through a pool، وSchedule a message
poolId Create a pool
verificationId Send a code
templateId Create a template
campaignId Create a campaign
webhookId Create a webhook
scheduledAt يُضبط على ساعة من الآن قبل تشغيل Schedule a message
  1. اضغط Import، واختر From file، ثم اختر smsfabric.insomnia.json.

  2. افتح Manage environments، واختر Base Environment، واضبط apiKey.

  3. شغّل Messages › Send a message.

لا يحفظ Insomnia المعرفات من الردود. انسخ id من الرد إلى متغير البيئة المقابل (messageId أو poolId أو verificationId أو templateId أو campaignId أو webhookId) قبل تشغيل طلب يستخدمه. وفي Schedule a message اضبط scheduledAt على وقت قادم بتوقيت UTC بالصيغة YYYY-MM-DDTHH:MM:SSZ.

المتغير القيمة
baseUrl https://api.smsfabric.com
apiKey مفتاح API الخاص بك. فارغ في الملفين.
  • Check a code: ضع مكان 123456 الأرقام التي وصلت إلى الهاتف.
  • Create a webhook: ضع عنوان HTTPS الخاص بك مكان https://example.com/hooks/smsfabric.
  • Send through a pool: أضف هاتفا واحدا على الأقل إلى مجموعة الأجهزة أولا، عبر PATCH /v1/devices/:id مع { "poolId": "…" }.
  • Create a campaign ينشئ مسودة لجهات الاتصال الموسومة vip. لا يُرسل شيء حتى تستدعي POST /v1/campaigns/:id/start، وقد تُرك هذا الطلب خارج المجموعة عمدا.
  • نص القالب مثل {{first_name|there}} هو صيغة المتغيرات الخاصة بـ SMSFabric ويُرسل كما هو. في Postman لا تنشئ متغيرا باسم first_name، وإلا ملأه Postman قبل خروج الطلب.