مرجع API
عقد واحد للواجهة الكاملة المخصصة للعملاء.
نقاط نهاية العملاء متاحة ضمن /api/v1. وتبقى البادئة القديمة /api متاحة للوحة التحكم، بينما ينبغي للتكاملات الجديدة على الخادم استخدام عنوان URL الأساسي ذي الإصدار.
حدود المصادقة
تستخدم تكاملات المنتج مفتاح API لمساحة العمل، ويمكنه أيضًا قراءة استخدام الحساب والتحليلات وبيانات وصفية لمفاتيح API. أما تغييرات الفوترة وإنشاء مفاتيح API أو إلغاؤها فتتطلب جلسة المتصفح المقتصرة على HTTP وهي موسومة وفق ذلك.
الموارد
الرسائل والسلاسل
أرسل واسترجع وابحث وردّ وافحص أحداث التسليم.
8 عملياتالتصنيفات وقواعد الفرز
نظّم البريد المرسَل والمستلَم في مجلدات تلقائيًا أو يدويًا.
9 عملياتالمسودات والمرفقات
ابنِ تدفقات المحرر مع تخزين خاص للمرفقات.
10 عملياتالقوالب المستضافة
صُغ وأنشئ المعاينة واختبر وأصدر وانشر وأرسل محتوى قابلًا لإعادة الاستخدام.
7 عملياتالنطاقات
جهّز هويات الإرسال وافهم حالة توثيق DNS.
8 عملياتالبريد الوارد
أنشئ العناوين وتعامل مع المحادثات المستلَمة.
5 عملياتقابلية التسليم
افحص الأحداث ونتائج السمعة والمستلِمين المحظورين.
8 عملياتالحساب والفوترة
اقرأ استخدام الحساب والتحليلات والبيانات الوصفية للمفاتيح باستخدام مفتاح API؛ أما تغييرات الفوترة وإنشاء المفاتيح أو إلغاؤها فتتطلب جلسة لوحة تحكم.
غلاف الأخطاء
تستخدم أخطاء JSON غلافًا واحدًا متوقَّعًا. وتميّز رموز الحالة بين المُدخلات غير الصالحة والمصادقة والموارد المفقودة والتعارضات ومتطلبات الدفع وحواجز الأمان وحدود الاستخدام.
{
"error": {
"message": "The sender domain is not verified",
"status": 403
}
}الإصدارات
يحدد إصدار API المبني على التاريخ هذا العقد. ويمكن إضافة حقول متوافقة مع الإصدارات السابقة ضمن الإصدار نفسه. أما التغييرات الجذرية فتتطلب مسارًا أساسيًا جديدًا ذا إصدار وانتقالًا موثَّقًا.
{
"version": "2026-09-07",
"baseUrl": "https://sendhq.cc/api/v1",
"openapi": "https://sendhq.cc/openapi.json"
}