apiللمطوّرين

مكان واحد لكل واجهات HostiGuard

اقرأ الأسعار، افحص وسجّل النطاقات، اطلب خوادم مخصّصة، أرسل رسائل SMS، واربط WHMCS أو ووردبريس — كل تكامل موثّق هنا، والتنزيلات في الأسفل.

عنوان URL الأساسي https://hostiguard.com/api/v1

نظرة عامة

تقدّم HostiGuard واجهة JSON صغيرة وواضحة. كل الطلبات عبر HTTPS، والمفاتيح تُرسل كـ Bearer، وكل ردّ يحمل علامة success. اختر التكامل الذي تحتاجه:

المصادقة

أنشئ مفتاحًا من لوحة التحكم ← الأعمال ← API. أرسله مع كل طلب في ترويسة Authorization. يُعرض المفتاح مرة واحدة فقط عند إنشائه؛ احفظه بأمان ولا تستخدمه أبدًا في شيفرة تعمل على جهة المتصفح.

Authorization: Bearer hg_live_4cf37e433aaf7c69fed5c47ce11bdb870753bb9a

لكل مفتاح صلاحيات محددة. أي طلب إلى نقطة نهاية لا يملك المفتاح صلاحيتها يُرجع 403.

lockaccount lockdomains lockservers lockclients

مفاتيح الموزّع والوضع التجريبي

الموزّع المفعَّل (لوحة العميل ← الموزّع ← API) يحصل على مفتاحين على هذه الواجهة نفسها. نطاقات مفاتيح الموزّع هي account وdomains وservers؛ أما نقاط العملاء الفرعيين فلحسابات الأعمال فقط. الأسعار التي تعود لمفتاح الموزّع تكون بسعر الموزّع مباشرة، ويُرفق سعر الموقع بجانبها باسم "retail".

hg_live_…

المفتاح الحيّ — أسعار حقيقية بسعر الموزّع وطلبات حقيقية تُدفع من رصيد محفظتك.

hg_test_…

المفتاح التجريبي — نفس القراءات، لكن كل طلب يُحاكى: يُتحقق من الطلب ويُسعَّر، ولا يُنشأ شيء ولا يُحصَّل شيء. استعمله لبناء تكاملك واختباره بأمان.

كل استجابة لمفتاح موزّع تحمل "mode" ‏("live" أو "test"). الطلب المحاكى يعود بـ200 (لا 201) مع "simulated": true ويخبرك هل كان الطلب نفسه سينجح بمفتاحك الحيّ:

{
    "success": true,
    "data": {
        "mode": "test",
        "simulated": true,
        "service_type": 3,
        "retail": 12.99,
        "discount": 2.6,
        "reseller_discount": 20,
        "amount": 10.39,
        "currency": "USD",
        "balance": 250
    }
}

تُعرض المفاتيح مرة واحدة عند إنشائها؛ وإعادة توليد مفتاح تُلغي السابق فوراً. أبقِ المفتاح الحيّ على خادمك فقط — لا في كود المتصفح أبداً.

keyاحصل على مفاتيح الموزّع

صيغة الاستجابة

تحتوي كل استجابة على مؤشر "success". تُرجع الاستدعاءات الناجحة النتيجة في "data"؛ وتُرجع الاستدعاءات الفاشلة كائن "error" يحتوي على "code" قابل للقراءة آليًا و"message" مفهومة للبشر.

{
    "success": true,
    "data": {
        "…": "…"
    }
}
{
    "success": false,
    "error": {
        "code": "insufficient_balance",
        "message": "Insufficient wallet balance.",
        "required": 169.99,
        "balance": 65.06
    }
}

رموز الأخطاء

401 المفتاح مفقود أو غير صالح أو مُلغى
402 رصيد المحفظة أقل من إجمالي الطلب (يتضمن الرد "required" و"balance")
403 حساب الأعمال غير نشط، أو المفتاح يفتقر إلى الصلاحية
404 المورد غير موجود (طلب، عميل فرعي، امتداد)
405 طريقة HTTP غير صحيحة
422 معامل غير صالح أو مفقود

المدفوعات

account_balance_wallet

تُدفع الطلبات المقدَّمة عبر API فورًا من رصيد محفظة الحساب. إذا لم يكن الرصيد كافيًا فلن يُنشأ الطلب وتُرجع الواجهة 402. أضف رصيدًا من لوحة التحكم ← الرصيد. جميع المدفوعات نهائية — راجع سياسة الاسترداد. سياسة الاسترجاع

واجهة الأعمال / الموزّع v1 — نقاط النهاية

مفاتيح الأعمال تستخدم نطاقات (scopes) المفتاح؛ ومفاتيح الموزّع (حيّ / تجريبي) تستخدم نقاط account و domains و servers بسعر الموزّع. كل نقطة مذكورة أدناه مع المعاملات ومثال cURL والردّ.

GET /account lockالصلاحية: account

الحساب

يُرجع بيانات الحساب والشركة ورصيد المحفظة وصلاحيات المفتاح المستخدم.

مثال

curl https://hostiguard.com/api/v1/account -H "Authorization: Bearer hg_live_…"

الاستجابة

{
    "success": true,
    "data": {
        "account_id": 1024,
        "name": "Alpha Web Agency",
        "company": "Alpha Web Agency",
        "account_type": "company",
        "balance": 250,
        "currency": "USD",
        "min_balance": 100,
        "key": {
            "name": "My website",
            "prefix": "hg_live_4cf37e43",
            "scopes": [
                "account",
                "domains"
            ]
        }
    }
}
GET /domains/pricing lockالصلاحية: domains

أسعار النطاقات

قائمة أسعار جميع الامتدادات (التسجيل، التجديد، النقل، الاستعادة — لكل سنة). لتصفية امتداد واحد استخدم tld.

المعاملات

tld اختياري الامتداد بدون النقطة، مثل com

مثال

curl "https://hostiguard.com/api/v1/domains/pricing?tld=com" -H "Authorization: Bearer hg_live_…"

الاستجابة

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "tld": ".com",
                "registration": 14.95,
                "renewal": 14.89,
                "transfer": 14.59,
                "restore": 103.9,
                "currency": "USD",
                "per": "year",
                "popular": true
            }
        ]
    }
}
GET /domains/check lockالصلاحية: domains

التحقق من نطاق

توفر اسم النطاق مع سعره. قيمة "available" تكون true أو false، أو null عند تعذر الوصول إلى السجل (أعد المحاولة لاحقًا).

المعاملات

domain مطلوب اسم النطاق الكامل، مثل mysite.com

مثال

curl "https://hostiguard.com/api/v1/domains/check?domain=mysite.com" -H "Authorization: Bearer hg_live_…"

الاستجابة

{
    "success": true,
    "data": {
        "domain": "mysite.com",
        "available": true,
        "status": "available",
        "price": {
            "registration": 14.95,
            "renewal": 14.89,
            "currency": "USD",
            "per": "year"
        }
    }
}
GET /domains lockالصلاحية: domains

قائمة النطاقات

جميع أسماء النطاقات في الحساب مع الحالة وتاريخ الانتهاء والعميل الفرعي المسندة إليه.

مثال

curl https://hostiguard.com/api/v1/domains -H "Authorization: Bearer hg_live_…"

الاستجابة

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "domain_id": 46,
                "domain": "mysite.com",
                "status": "active",
                "auto_renew": true,
                "registered": "2026-09-22 00:00:00",
                "expires": "2027-09-21 00:00:00",
                "client_id": 12
            }
        ]
    }
}
POST /domains/register lockالصلاحية: domains

تسجيل نطاق

يسجّل النطاق لعدد السنوات المحدد ويدفع ثمنه من المحفظة. ويمكن اختياريًا إسناده إلى عميل فرعي.

المعاملات

domain مطلوب اسم النطاق الكامل، مثل mysite.com
years اختياري مدة التسجيل بالسنوات، من 1 إلى 10 (الافتراضي 1)
privacy اختياري true لتفعيل حماية خصوصية WHOIS حيث يسمح الامتداد بذلك
nameservers اختياري قائمة خوادم الأسماء التي تُضبط بعد التسجيل
client_id اختياري معرّف العميل الفرعي الذي تُسند إليه الخدمة

مثال

curl -X POST https://hostiguard.com/api/v1/domains/register \
  -H "Authorization: Bearer hg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"domain":"mysite.com","years":1,"privacy":true,"client_id":12}'

الاستجابة

{
    "success": true,
    "data": {
        "payment_id": 114,
        "order_id": 158,
        "invoice_id": 181,
        "invoice_number": "INV-2026-0072",
        "service_id": 46,
        "service_type": 3,
        "status": 1,
        "client_id": 12,
        "amount": 14.95,
        "currency": "USD",
        "balance": 235.05
    }
}
GET /servers/plans lockالصلاحية: servers

خطط الخوادم المخصصة

خطط الخوادم المخصصة المتاحة مع مواصفاتها وأسعارها لكل دورة فوترة.

مثال

curl https://hostiguard.com/api/v1/servers/plans -H "Authorization: Bearer hg_live_…"

الاستجابة

{
    "success": true,
    "data": {
        "count": 3,
        "items": [
            {
                "plan_id": 2,
                "name": "Performance Dedicated",
                "slug": "performance-dedicated",
                "description": "High-traffic applications",
                "features": [
                    {
                        "text": "16-Core CPU (E5-2680)",
                        "type": "check"
                    }
                ],
                "pricing": {
                    "monthly": {
                        "price": 169.99,
                        "setup_fee": 0
                    },
                    "yearly": {
                        "price": 1799.88,
                        "setup_fee": 0
                    }
                },
                "currency": "USD"
            }
        ]
    }
}
GET /servers lockالصلاحية: servers

قائمة الخوادم

جميع الخوادم المخصصة في الحساب مع الحالة وعنوان IP والتواريخ والعميل الفرعي المسند إليه.

مثال

curl https://hostiguard.com/api/v1/servers -H "Authorization: Bearer hg_live_…"

الاستجابة

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "server_id": 1,
                "plan_id": 2,
                "plan": "Performance Dedicated",
                "hostname": "srv1.example.com",
                "ip_address": "203.0.113.10",
                "status": "active",
                "billing_cycle": "monthly",
                "date_start": "2026-09-22",
                "date_expires": "2026-10-21",
                "client_id": 12
            }
        ]
    }
}
POST /servers/order lockالصلاحية: servers

طلب خادم مخصص

يطلب خطة لدورة الفوترة المحددة ويدفع ثمنها من المحفظة. ثم يُجهَّز الخادم كما في طلبات الموقع.

المعاملات

plan_id مطلوب plan_id من /servers/plans
billing_cycle مطلوب monthly أو quarterly أو semiannual أو yearly (الدورات المدرجة في أسعار الخطة فقط)
hostname اختياري اسم المضيف (hostname) للخادم
client_id اختياري معرّف العميل الفرعي الذي تُسند إليه الخدمة

مثال

curl -X POST https://hostiguard.com/api/v1/servers/order \
  -H "Authorization: Bearer hg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"plan_id":2,"billing_cycle":"monthly","hostname":"srv1.example.com","client_id":12}'

الاستجابة

{
    "success": true,
    "data": {
        "payment_id": 115,
        "order_id": 159,
        "invoice_id": 182,
        "invoice_number": "INV-2026-0073",
        "service_id": 1,
        "service_type": 5,
        "status": 1,
        "client_id": 12,
        "amount": 169.99,
        "currency": "USD",
        "balance": 65.06
    }
}
GET /orders/{id} lockالصلاحية: account

تفاصيل الطلب

حالة طلب واحد وعناصره وفواتيره.

مثال

curl https://hostiguard.com/api/v1/orders/158 -H "Authorization: Bearer hg_live_…"

الاستجابة

{
    "success": true,
    "data": {
        "order_id": 158,
        "status": "complete",
        "total": 89.99,
        "currency": "USD",
        "created_at": "2026-09-22 04:00:19",
        "items": [
            {
                "item_id": 211,
                "service_type": "dedicated",
                "service_id": 1,
                "price": 89.99,
                "setup_fee": 0,
                "next_due": "2026-10-21",
                "status": 1
            }
        ],
        "invoices": [
            {
                "invoice_id": 181,
                "number": "INV-2026-0072",
                "total": 89.99,
                "status": 1,
                "date_paid": "2026-09-22 04:00:19"
            }
        ]
    }
}
GET /clients lockالصلاحية: clients

قائمة العملاء الفرعيين

العملاء الفرعيون في الحساب مع عدد الخدمات المسندة إلى كل منهم.

مثال

curl https://hostiguard.com/api/v1/clients -H "Authorization: Bearer hg_live_…"

الاستجابة

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "client_id": 12,
                "account_id": 201,
                "full_name": "Mohammed Al-Rashid",
                "company": "Rashid Trading LLC",
                "email": "mohammed@example.com",
                "phone": "+971500000001",
                "status": "active",
                "services": 3,
                "created_at": "2026-09-22 03:58:15"
            }
        ]
    }
}
POST /clients lockالصلاحية: clients

إنشاء عميل فرعي

ينشئ عميلاً فرعياً بحساب دخول خاص به في HostiGuard؛ تُرسل كلمة المرور إلى البريد المحدد. استخدم client_id الخاص به عند الطلب.

المعاملات

full_name مطلوب اسم الشخص أو الشركة
company اختياري اسم الشركة
email مطلوب عنوان البريد الإلكتروني
phone اختياري رقم الهاتف
notes اختياري ملاحظات داخلية

مثال

curl -X POST https://hostiguard.com/api/v1/clients \
  -H "Authorization: Bearer hg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"full_name":"Ibrahim Saleh","email":"ibrahim@example.com"}'

الاستجابة

{
    "success": true,
    "data": {
        "client_id": 13,
        "account_id": 205,
        "full_name": "Ibrahim Saleh",
        "company": null,
        "email": "ibrahim@example.com",
        "phone": null,
        "status": "active",
        "services": 0,
        "created_at": "2026-09-22 04:00:02"
    }
}

واجهة الرسائل النصية (SMS API)

أرسل الرسائل النصية برمجياً من خدمة SMS مفعّلة. كل رسالة تُخصم من حجم باقة الخدمة المرتبطة بالمفتاح.

أنشئ مفتاحاً من لوحة العميل ← SMS ← مفاتيح API وأرسله في ترويسة Authorization. إن كان للمفتاح سرّ (secret) فأرسله في الجسم باسم api_secret.

Authorization: Bearer sk_your_sms_key
POST https://hostiguard.com/api/sms/send

المعاملات

toمطلوبرقم المستلم بالصيغة الدولية (+1234567890).
messageمطلوبنص الرسالة.
api_secretاختياريمطلوب فقط عندما يكون للمفتاح سرّ.

مثال

curl -X POST https://hostiguard.com/api/sms/send \
  -H "Authorization: Bearer sk_your_sms_key" \
  -H "Content-Type: application/json" \
  -d '{"to":"+1234567890","message":"Hello from HostiGuard!","api_secret":"your_secret"}'

الاستجابة

{
    "success": true,
    "message": "SMS sent successfully.",
    "data": {
        "to": "+1234567890",
        "message_id": "msg_8f7b0d2c91aa41c3"
    }
}

رموز الأخطاء

401مفتاح مفقود/غير صالح، أو api_secret خاطئ
400حقل "to" أو "message" مفقود
402لم يبقَ رصيد رسائل في الباقة
403خدمة SMS غير مفعّلة أو موقوفة

تُدار المفاتيح والأسرار من Dashboard → SMS

ويبهوكات الدفع (واردة)

هذه هي الروابط التي يستمع عليها HostiGuard. الصق الرابط المناسب في لوحة كل بوابة دفع لتُؤكَّد المدفوعات وتُعلَّم الفواتير مدفوعة دون أي خطوة يدوية. التواقيع تُتحقّق بالسرّ المحفوظ في الأدمن ← الإعدادات ← الدفع والواجهات.

البوابةرابط الويبهوكالأحداث المعالَجة
Stripe POST https://hostiguard.com/api/webhooks/stripe checkout.session.completed · payment_intent.payment_failed · charge.refunded
PayPal POST https://hostiguard.com/api/webhooks/paypal CHECKOUT.ORDER.APPROVED · PAYMENT.CAPTURE.COMPLETED · PAYMENT.CAPTURE.DENIED / DECLINED
Paddle POST https://hostiguard.com/api/webhooks/paddle transaction.completed · transaction.paid
Airwallex POST https://hostiguard.com/api/webhooks/airwallex payment_intent.succeeded · payment_intent.requires_capture · payment_intent.captured
Amazon Pay POST https://hostiguard.com/api/webhooks/amazonpay Checkout session / charge notifications (checkoutSessionId or chargeId)
Network (N-Genius) POST / GET https://hostiguard.com/api/webhooks/network TRANSACTION_STATE_CHANGED (state CAPTURED / AUTHORISED)
XaPay (crypto) POST https://hostiguard.com/api/webhooks/xapay status "paid" / event "invoice.paid"

يُردّ على الويبهوك بـ HTTP 200 حتى عند تجاهل الحدث؛ وفشل التحقق من التوقيع يعيد 400/401 ويُسجَّل.

وحدات WHMCS

v1.0.0 · WHMCS 7.10+ / 8.x

وحدتان في أرشيف واحد: وحدة مسجِّل نطاقات ووحدة تزويد خوادم مخصّصة. كلتاهما تتخاطب مع API v1 بمفتاح الأعمال أو الموزّع؛ وتُدفع الطلبات من محفظتك في HostiGuard بسعر الموزّع.

ماذا تفعل

  • check_circleبحث توفّر النطاقات لكل امتداد واستيراد أسعار الامتدادات إلى WHMCS.
  • check_circleتسجيل النطاق بالمدة وحماية الهوية والنيم سيرفرات؛ ومزامنة المعلومات وتاريخ الانتهاء.
  • check_circleمنتجات الخوادم المخصّصة: قائمة الباقات تُحمَّل مباشرة، الطلب عند "Create"، وتُحفظ معرّفات HostiGuard على الخدمة.
  • check_circleمنطقة العميل وتبويب الأدمن يعرضان اسم المضيف وعنوان IP والحالة والانتهاء من HostiGuard مباشرة.
  • check_circleمفتاح الموزّع التجريبي (hg_test_…) يحاكي كل طلب — مثالي لنسخة WHMCS تجريبية.

التثبيت

  1. نزّل الأرشيف أدناه وفكّه في جذر WHMCS (يضيف modules/registrars/hostiguard و modules/servers/hostiguardservers).
  2. Setup ← Products/Services ← Domain Registrars ← HostiGuard ← Activate؛ أدخل رابط HostiGuard ومفتاح الـ API.
  3. اختياري: Setup ← Domain Pricing ← Import TLD pricing لسحب الأسعار من HostiGuard.
  4. Setup ← Servers ← Add New Server: الوحدة HostiGuard Dedicated Servers، اسم المضيف = رابط HostiGuard، فعّل SSL، access hash = مفتاح الـ API؛ ثم أنشئ مجموعة خوادم.
  5. المنتج ← Module Settings: اختر باقة HostiGuard ودورة الفوترة. السجلات: Utilities ← Logs ← Module Log.
جيد أن تعرف: التجديد والنقل وتغيير النيم سيرفرات ورموز EPP والإيقاف/الإنهاء غير متاحة في API v1 بعد — تُنفَّذ من لوحة HostiGuard، والوحدات تقول ذلك صراحة بدل الفشل بصمت.
extension

WHMCS modules (registrar + dedicated servers)

hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 ملفات · v1.0.0

downloadتنزيل

إضافة ووردبريس — HostiGuard Connector

v1.0.0 · WordPress 5.8+ · PHP 7.4+

بِع نطاقات HostiGuard وخوادمها المخصّصة من موقع ووردبريس الخاص بك. تعمل دون WooCommerce (يُحوَّل الزائر إلى HostiGuard لإتمام الطلب) أو معه (تقبض في متجرك، وتزوّد الإضافة من HostiGuard بعد الدفع).

ماذا تفعل

  • check_circle[hostiguard_domain_search] — توفّر وسعر مباشران مع امتدادات بديلة.
  • check_circle[hostiguard_domain_pricing] و [hostiguard_server_plans] — جداول وكروت تُغذّى من الـ API مع تخزين مؤقّت.
  • check_circleWooCommerce: يُضاف النطاق إلى السلة بسعره الحيّ؛ وبعد الدفع يُسجَّل عبر مفتاحك.
  • check_circleاربط أي منتج WooCommerce بباقة خادم HostiGuard (بيانات المنتج ← تبويب HostiGuard)؛ يُطلب عند الدفع.
  • check_circleالنتائج والأخطاء في ملاحظات الطلب، إعادة المحاولة من إجراءات الطلب، وصفحة الإعدادات تعرض الاتصال والرصيد.

التثبيت

  1. نزّل الملف المضغوط أدناه؛ ووردبريس ← الإضافات ← أضف جديد ← رفع إضافة ← تفعيل.
  2. الإعدادات ← HostiGuard: أدخل رابط HostiGuard ومفتاح الـ API. تؤكد الصفحة الاتصال وتعرض رصيدك ووضع المفتاح.
  3. ضع [hostiguard_domain_search] (وبقية الشورت كودات) في أي صفحة.
  4. WooCommerce (اختياري): أنشئ منتجاً بسيطاً باسم "تسجيل نطاق"، اختره في الإعدادات وحوّل زر التسجيل إلى وضع WooCommerce.
  5. لبيع الخوادم: عدّل منتجاً ← بيانات المنتج ← HostiGuard ← اختر الباقة والدورة.

الشورت كودات

[hostiguard_domain_search]بحث نطاقات بسعر حيّ. الخصائص: tlds="com,net,org"، placeholder، button.
[hostiguard_domain_pricing]جدول أسعار لكل امتداد. الخصائص: tlds للتحديد، columns="registration,renewal,transfer".
[hostiguard_server_plans]كروت باقات الخوادم المخصّصة. الخصائص: cycle، button، link.
جيد أن تعرف: الإضافة تزوّد من HostiGuard بعد دفع الطلب فقط؛ أبقِ رصيد محفظتك أعلى من الطلبات المتوقعة. التجديدات تُفوتَر على حسابك في HostiGuard عند الانتهاء.

التنزيلات

الحزمتان تُبنيان من الشيفرة نفسها المشحونة مع هذا الإصدار من HostiGuard، لذا تطابق دائماً الـ API الموثّق أعلاه.

extension

WHMCS modules (registrar + dedicated servers)

hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 ملفات · v1.0.0

downloadتنزيل
widgets

WordPress plugin (HostiGuard Connector)

hostiguard-connector-1.0.0.zip · 20 KB · 9 ملفات · v1.0.0

downloadتنزيل
الإصدارات: الوحدات تتبع الـ API. كلما تغيّرت نقطة نهاية أو أُضيفت جديدة تُحدَّث وحدات WHMCS وإضافة ووردبريس وتُعاد نشرها هنا برقم إصدار جديد — أعد تنزيلها بعد أي تحديث للـ API.

سجل التغييرات

  • new_releasesv1.0.0 — أول إصدار للتوثيق الموحّد ووحدتَي WHMCS (المسجِّل + التزويد) وإضافة HostiGuard Connector لووردبريس (API v1).

فصلك القادم يبدأ من هنا.

قوِّ أعمالك باستضافة مصمّمة للنمو.