Email API

أضف قوة التسويق بالبريد إلى برمجياتك

كل ما في اللوحة موجود في الـAPI أيضًا: أضف مشتركين وأدر القوائم والشرائح وأنشئ الحملات وأرسلها وحلّلها — كلها endpoints موثقة تحت /api/v1/.

ابدأ مجانًا توثيق Swagger

مصادقة JWT مخطط OpenAPI 3.0 ويب هوك موقّعة بـHMAC

أنشئ حملة وأرسلها

$ curl -X POST https://new.qulaq.com/api/v1/campaigns/ \
  -H "Authorization: Bearer eyJ0eXAiOiJKV1…" \
  -d '{
    "name": "Mart Bülteni",
    "subject": "Bu ayın gelişmeleri",
    "sender_identity_id": "…",
    "template_id": "…",
    "list_ids": ["…"]
  }'

// ثم أرسل بطلب واحد:
$ curl -X POST …/api/v1/campaigns/{id}/send/

// الاستجابة · 201 Created
{
  "data": { "status": "sending" },
  "meta": {}, "errors": []
}

endpoints التسويق

التدفق كاملًا، من المشترك إلى التقرير

كل الطلبات تستخدم رمز Bearer — احصل على رمزك من /auth/login/.

POST /subscribers/bulk/

ينشئ مشتركين دفعة واحدة. الإضافة الفردية عبر /subscribers/، واستيراد CSV عبر /lists/{id}/import/.

POST /campaigns/{id}/send/

يرسل الحملة فورًا. للجدولة /schedule/، وللتجربة أولًا /test/.

GET /campaigns/{id}/report/

يعيد تقرير الحملة: الفتح والنقر والارتداد والشكاوى. سجلات الإرسال عبر /campaigns/send-logs/.

GET /segments/{id}/preview/

يعاين المشتركين المطابقين لشريحة قائمة على قواعد. إنشاء الشرائح: POST /segments/.

أكثر من 80 endpoint تشمل القوالب والمزودين وهويات المرسل والتحقق: new.qulaq.com/api/v1/docs/

ويب هوك

لتصل الأحداث إليك

عرّف ويب هوك لأحداث المشتركين والحملات والبريد: العناوين المرتدة أو المشتكية تصل نظامك فورًا دون استعلام.

12 حدثًا: subscriber.bounced، email.opened… توقيع HMAC SHA-256 — ترويسة X-Qulaq-Signature 5 محاولات إعادة مع exponential backoff سجلات التسليم: /webhooks/{id}/deliveries/

POST /webhooks/

{
  "url": "https://ornek.com/webhook",
  "events": [
    "subscriber.bounced",
    "subscriber.complained",
    "email.delivered"
  ],
  "is_active": true
}

// X-Qulaq-Signature: hmac_sha256(secret, body)

الأرصدة نفسها · اللوحة + الـAPI

أرسل طلبك الأول اليوم

افتح حسابك المجاني واحصل على رمزك. أرصدتك تُخصم من الرصيد نفسه في اللوحة والـAPI.

ابدأ مجانًا اطّلع على الأسعار

لا حاجة لبطاقة ائتمان الأرصدة لا تنتهي

من المدونة

المدونة

اقرأ المزيد

12 يوليو 2026

أرسل أول حملة لك عبر Qulaq API في 10 دقائق

احصل على token، أنشئ الحملة، ثم أرسلها: ثلاثة طلبات تضع أساس أتمتة التسويق لديك.

اقرأ المزيد

12 يوليو 2026

أحداث البريد الإلكتروني اللحظية عبر webhooks

بدل الاستعلام المتكرر عن حالات bounce والشكاوى، دعها تصل إلى نظامك فورًا: دليل webhook موقّع بـ HMAC.

اقرأ المزيد

12 يوليو 2026

التحقق الفوري من البريد الإلكتروني داخل نموذج التسجيل

أوقف العناوين غير الصالحة عند لحظة التسجيل نفسها: دليل ربط النموذج بواجهة verify API.

اقرأ المزيد