اقرأ الأسعار، افحص وسجّل النطاقات، اطلب خوادم مخصّصة، أرسل رسائل SMS، واربط WHMCS أو ووردبريس — كل تكامل موثّق هنا، والتنزيلات في الأسفل.
https://hostiguard.com/api/v1
تقدّم HostiGuard واجهة JSON صغيرة وواضحة. كل الطلبات عبر HTTPS، والمفاتيح تُرسل كـ Bearer، وكل ردّ يحمل علامة success. اختر التكامل الذي تحتاجه:
الحساب، أسعار النطاقات وتوفّرها، التسجيل، باقات الخوادم المخصّصة وطلبها، استعلام الطلبات، العملاء الفرعيون.
أرسل رسائل SMS من تطبيقك بمفتاح خدمة رسائل مفعّلة.
روابط الاستدعاء التي يجب أن تناديها كل بوابة دفع لتُعلَّم الفواتير مدفوعة تلقائياً.
وحدة مسجِّل (النطاقات) ووحدة تزويد (الخوادم المخصّصة) — أعد بيع HostiGuard داخل WHMCS.
بحث النطاقات، جداول الأسعار، باقات الخوادم، والتزويد عبر WooCommerce على موقعك.
الحزمتان تُبنيان من الشيفرة نفسها المشحونة مع هذا الإصدار من HostiGuard، لذا تطابق دائماً الـ API الموثّق أعلاه.
أنشئ مفتاحًا من لوحة التحكم ← الأعمال ← API. أرسله مع كل طلب في ترويسة Authorization. يُعرض المفتاح مرة واحدة فقط عند إنشائه؛ احفظه بأمان ولا تستخدمه أبدًا في شيفرة تعمل على جهة المتصفح.
Authorization: Bearer hg_live_4cf37e433aaf7c69fed5c47ce11bdb870753bb9a
لكل مفتاح صلاحيات محددة. أي طلب إلى نقطة نهاية لا يملك المفتاح صلاحيتها يُرجع 403.
الموزّع المفعَّل (لوحة العميل ← الموزّع ← 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 | معامل غير صالح أو مفقود |
تُدفع الطلبات المقدَّمة عبر API فورًا من رصيد محفظة الحساب. إذا لم يكن الرصيد كافيًا فلن يُنشأ الطلب وتُرجع الواجهة 402. أضف رصيدًا من لوحة التحكم ← الرصيد. جميع المدفوعات نهائية — راجع سياسة الاسترداد. سياسة الاسترجاع
مفاتيح الأعمال تستخدم نطاقات (scopes) المفتاح؛ ومفاتيح الموزّع (حيّ / تجريبي) تستخدم نقاط account و domains و servers بسعر الموزّع. كل نقطة مذكورة أدناه مع المعاملات ومثال cURL والردّ.
/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"
]
}
}
}
/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
}
]
}
}
/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"
}
}
}
/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
}
]
}
}
/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
}
}
/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"
}
]
}
}
/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
}
]
}
}
/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
}
}
/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"
}
]
}
}
/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"
}
]
}
}
/clients
lockالصلاحية: clients
ينشئ عميلاً فرعياً بحساب دخول خاص به في HostiGuard؛ تُرسل كلمة المرور إلى البريد المحدد. استخدم client_id الخاص به عند الطلب.
المعاملات
| full_name | مطلوب | اسم الشخص أو الشركة |
| company | اختياري | اسم الشركة |
| مطلوب | عنوان البريد الإلكتروني | |
| 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 مفعّلة. كل رسالة تُخصم من حجم باقة الخدمة المرتبطة بالمفتاح.
أنشئ مفتاحاً من لوحة العميل ← SMS ← مفاتيح API وأرسله في ترويسة Authorization. إن كان للمفتاح سرّ (secret) فأرسله في الجسم باسم api_secret.
Authorization: Bearer sk_your_sms_key
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 ويُسجَّل.
وحدتان في أرشيف واحد: وحدة مسجِّل نطاقات ووحدة تزويد خوادم مخصّصة. كلتاهما تتخاطب مع API v1 بمفتاح الأعمال أو الموزّع؛ وتُدفع الطلبات من محفظتك في HostiGuard بسعر الموزّع.
ماذا تفعل
التثبيت
hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 ملفات · v1.0.0
بِع نطاقات HostiGuard وخوادمها المخصّصة من موقع ووردبريس الخاص بك. تعمل دون WooCommerce (يُحوَّل الزائر إلى HostiGuard لإتمام الطلب) أو معه (تقبض في متجرك، وتزوّد الإضافة من 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، لذا تطابق دائماً الـ API الموثّق أعلاه.
hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 ملفات · v1.0.0
hostiguard-connector-1.0.0.zip · 20 KB · 9 ملفات · v1.0.0
قوِّ أعمالك باستضافة مصمّمة للنمو.