apiGeliştiriciler

Tüm HostiGuard API'leri tek yerde

Fiyatları okuyun, alan adlarını kontrol edip kaydedin, özel sunucu sipariş edin, SMS gönderin ve WHMCS veya WordPress'i bağlayın — her entegrasyon burada belgelenmiştir, indirmeler en alttadır.

Temel URL https://hostiguard.com/api/v1

Genel bakış

HostiGuard küçük ve öngörülebilir bir JSON API sunar. Tüm istekler HTTPS üzerinden gider, anahtarlar Bearer token olarak gönderilir ve her yanıt bir success bayrağı taşır. İhtiyacınız olan entegrasyonu seçin:

Kimlik doğrulama

Panel → Business → API bölümünden bir anahtar oluşturun. Her istekte Authorization başlığında gönderin. Anahtar oluşturulduğunda yalnızca bir kez gösterilir; güvenle saklayın ve asla tarayıcı tarafındaki kodda kullanmayın.

Authorization: Bearer hg_live_4cf37e433aaf7c69fed5c47ce11bdb870753bb9a

Her anahtarın yetkileri vardır. Anahtarın yetkisi olmayan bir uç noktaya yapılan istek 403 döndürür.

lockaccount lockdomains lockservers lockclients

Bayi anahtarları ve test modu

Aktif bir bayi (Panel → Bayi → API) bu aynı API için iki anahtar alır. Bayi anahtarlarının account, domains ve servers yetkileri vardır; alt müşteri uç noktaları yalnızca Business hesapları içindir. Bir bayi anahtarına döndürülen fiyatlar zaten bayi fiyatıdır — herkese açık fiyat yanında "retail" olarak verilir.

hg_live_…

Canlı anahtar — bayi fiyatınızla gerçek fiyatlar ve cüzdan bakiyenizden ödenen gerçek siparişler.

hg_test_…

Test anahtarı — aynı okumalar, ancak her sipariş simüle edilir: istek doğrulanır ve fiyatlandırılır, hiçbir şey oluşturulmaz ve ücretlendirilmez. Entegrasyonunuzu güvenle kurmak ve test etmek için kullanın.

Bayi anahtarından gelen her yanıt "mode" ("live" veya "test") içerir. Simüle edilen bir sipariş 200 (201 değil) ve "simulated": true ile yanıt verir ve aynı çağrının canlı anahtarınızla başarılı olup olmayacağını söyler:

{
    "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
    }
}

Anahtarlar oluşturulduğunda bir kez gösterilir; bir anahtarı yeniden oluşturmak öncekini hemen iptal eder. Canlı anahtarı yalnızca sunucunuzda tutun — asla tarayıcı tarafındaki kodda kullanmayın.

keyBayi anahtarlarınızı alın

Yanıt biçimi

Her yanıtta bir "success" işareti bulunur. Başarılı çağrılar sonucu "data" içinde döndürür; başarısız çağrılar makine tarafından okunabilir bir "code" ve insan tarafından okunabilir bir "message" içeren bir "error" nesnesi döndürür.

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

Hata kodları

401 Eksik, geçersiz veya iptal edilmiş anahtar
402 Cüzdan bakiyesi sipariş toplamından düşük ("required" ve "balance" dahil edilir)
403 Business hesabı aktif değil veya anahtarın yetkisi yok
404 Kaynak bulunamadı (sipariş, alt müşteri, uzantı)
405 Yanlış HTTP yöntemi
422 Geçersiz veya eksik parametre

Ödemeler

account_balance_wallet

API üzerinden verilen siparişler hesabın cüzdan bakiyesinden hemen ödenir. Bakiye yeterli değilse sipariş oluşturulmaz ve API 402 döndürür. Panel → Bakiye bölümünden bakiye yükleyin. Tüm ödemeler kesindir — İade Politikası'na bakın. İade politikası

Business / Reseller API v1 — uç noktalar

Business anahtarları anahtarın kapsamlarını kullanır; bayi anahtarları (live / test) hesap, alan adı ve sunucu uç noktalarını bayi fiyatıyla kullanabilir. Her uç nokta aşağıda parametreleri, bir cURL örneği ve yanıtıyla listelenmiştir.

Uç noktalar

GET /account lockYetki: account

Hesap

Hesabı, şirketi, cüzdan bakiyesini ve kullanılan anahtarın yetkilerini döndürür.

Örnek

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

Yanıt

{
    "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 lockYetki: domains

Alan adı fiyatları

Tüm uzantıların fiyat listesi (kayıt, yenileme, transfer, geri yükleme — yıllık). tld ile tek bir uzantı filtreleyin.

Parametreler

tld isteğe bağlı noktasız uzantı, örn. com

Örnek

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

Yanıt

{
    "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 lockYetki: domains

Alan adı kontrolü

Bir alan adının uygunluğu ve fiyatı. "available" true, false veya kayıt otoritesine ulaşılamadığında null olur (daha sonra tekrar deneyin).

Parametreler

domain zorunlu tam alan adı, örn. mysite.com

Örnek

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

Yanıt

{
    "success": true,
    "data": {
        "domain": "mysite.com",
        "available": true,
        "status": "available",
        "price": {
            "registration": 14.95,
            "renewal": 14.89,
            "currency": "USD",
            "per": "year"
        }
    }
}
GET /domains lockYetki: domains

Alan adlarını listele

Hesabın tüm alan adları; durum, bitiş tarihi ve atandığı alt müşteriyle.

Örnek

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

Yanıt

{
    "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 lockYetki: domains

Alan adı kaydedin

Alan adını belirtilen yıl sayısı için kaydeder ve cüzdandan öder. İsteğe bağlı olarak bir alt müşteriye atar.

Parametreler

domain zorunlu tam alan adı, örn. mysite.com
years isteğe bağlı yıl cinsinden kayıt süresi, 1–10 (varsayılan 1)
privacy isteğe bağlı uzantının izin verdiği durumlarda WHOIS gizliliğini açmak için true
nameservers isteğe bağlı kayıttan sonra ayarlanacak ad sunucularının listesi
client_id isteğe bağlı hizmetin atanacağı alt müşterinin ID'si

Örnek

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}'

Yanıt

{
    "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 lockYetki: servers

Dedicated sunucu paketleri

Özellikleri ve fatura dönemine göre fiyatlarıyla mevcut dedicated sunucu paketleri.

Örnek

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

Yanıt

{
    "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 lockYetki: servers

Sunucuları listele

Hesabın tüm dedicated sunucuları; durum, IP, tarihler ve atanan alt müşteriyle.

Örnek

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

Yanıt

{
    "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 lockYetki: servers

Dedicated sunucu sipariş et

Belirtilen fatura dönemi için bir paket sipariş eder ve cüzdandan öder. Sunucu ardından bir web sitesi siparişi gibi kurulur.

Parametreler

plan_id zorunlu /servers/plans'tan plan_id
billing_cycle zorunlu monthly, quarterly, semiannual veya yearly (yalnızca paket fiyatlandırmasında listelenen dönemler)
hostname isteğe bağlı sunucunun ana bilgisayar adı
client_id isteğe bağlı hizmetin atanacağı alt müşterinin ID'si

Örnek

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}'

Yanıt

{
    "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} lockYetki: account

Sipariş ayrıntıları

Bir siparişin durumu, kalemleri ve faturaları.

Örnek

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

Yanıt

{
    "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 lockYetki: clients

Alt müşterileri listele

Hesabın alt müşterileri ve her birine atanan hizmet sayısı.

Örnek

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

Yanıt

{
    "success": true,
    "data": {
        "count": 1,
        "items": [
            {
                "client_id": 12,
                "account_id": 201,
                "full_name": "Mohammed Al-Rashid",
                "company": "Rashid Trading LLC",
                "email": "[email protected]",
                "phone": "+971500000001",
                "status": "active",
                "services": 3,
                "created_at": "2026-09-22 03:58:15"
            }
        ]
    }
}
POST /clients lockYetki: clients

Alt müşteri oluştur

Kendi HostiGuard girişine sahip bir alt müşteri oluşturur; şifre verilen adrese e-postayla gönderilir. Sipariş verirken client_id değerini kullanın.

Parametreler

full_name zorunlu kişinin veya şirketin adı
company isteğe bağlı şirket adı
email zorunlu e-posta adresi
phone isteğe bağlı telefon numarası
notes isteğe bağlı dahili notlar

Örnek

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":"[email protected]"}'

Yanıt

{
    "success": true,
    "data": {
        "client_id": 13,
        "account_id": 205,
        "full_name": "Ibrahim Saleh",
        "company": null,
        "email": "[email protected]",
        "phone": null,
        "status": "active",
        "services": 0,
        "created_at": "2026-09-22 04:00:02"
    }
}

SMS API

Etkin bir SMS hizmetinden programla kısa mesaj gönderin. Her mesaj, anahtara bağlı hizmetin paket hacminden düşülür.

Panel → SMS → API anahtarları'nda bir anahtar oluşturun ve Authorization başlığında gönderin. Anahtar için bir secret belirlendiyse, gövdede api_secret olarak gönderin.

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

Parametreler

tozorunluUluslararası biçimde hedef numara (+1234567890).
messagezorunluMesaj metni.
api_secretisteğe bağlıYalnızca anahtarın secret'ı varsa gereklidir.

Örnek

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"}'

Yanıt

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

Hata kodları

401Eksik / geçersiz anahtar veya yanlış api_secret
400"to" veya "message" eksik
402Pakette SMS hacmi kalmadı
403SMS hizmeti etkin değil veya askıda

Anahtarlar ve secret'lar şurada yönetilir: Dashboard → SMS

Ödeme webhook'ları (gelen)

Bunlar HostiGuard'ın dinlediği URL'lerdir. Ödemelerin onaylanması ve faturaların elle işlem gerekmeden ödendi işaretlenmesi için doğru olanı her ağ geçidinin paneline yapıştırın. İmzalar, Yönetici → Ayarlar → Ödemeler ve API'ler'de kayıtlı secret ile doğrulanır.

Ağ geçidiWebhook URL'siİşlenen olaylar
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)

Olay yok sayılsa bile webhook HTTP 200 ile onaylanır; başarısız imza kontrolleri 400/401 döndürür ve kaydedilir.

WHMCS modülleri

v1.0.0 · WHMCS 7.10+ / 8.x

Tek arşivde iki modül: bir alan adı kayıt firması modülü ve bir özel sunucu hazırlama modülü. İkisi de Business veya Reseller anahtarınızla API v1 ile konuşur; siparişler bayi fiyatınızla HostiGuard cüzdanınızdan ödenir.

Ne yapar

  • check_circleTLD bazında alan adı uygunluk araması ve TLD fiyatlarının WHMCS'e aktarılması.
  • check_circleSüre, kimlik koruması ve ad sunucularıyla alan adı kaydı; bilgi ve bitiş tarihi senkronizasyonu.
  • check_circleÖzel sunucu ürünleri: paket listesi canlı yüklenir, "Create" ile sipariş verilir, HostiGuard kimlikleri hizmette saklanır.
  • check_circleMüşteri alanı ve yönetici sekmesi, ana bilgisayar adını, IP'yi, durumu ve bitiş tarihini doğrudan HostiGuard'dan gösterir.
  • check_circleBir bayi test anahtarı (hg_test_…) her siparişi simüle eder — test ortamındaki bir WHMCS için ideal.

Kurulum

  1. Aşağıdaki arşivi indirin ve WHMCS'inizin kök dizinine açın (modules/registrars/hostiguard ve modules/servers/hostiguardservers ekler).
  2. Setup → Products/Services → Domain Registrars → HostiGuard → Activate; HostiGuard URL'nizi ve API anahtarınızı girin.
  3. İsteğe bağlı: Fiyatları HostiGuard'dan çekmek için Setup → Domain Pricing → Import TLD pricing.
  4. Setup → Servers → Add New Server: modül HostiGuard Dedicated Servers, hostname = HostiGuard URL'niz, SSL açık, access hash = API anahtarı; bir sunucu grubu oluşturun.
  5. Ürün → Module Settings: HostiGuard paketini ve fatura dönemini seçin. Kayıtlar: Utilities → Logs → Module Log.
Bilmekte fayda var: yenilemeler, transferler, ad sunucusu değişiklikleri, EPP kodları ve askıya alma / sonlandırma henüz API v1 ile sunulmuyor — bu işlemler HostiGuard panelinden yapılır ve modüller sessizce başarısız olmak yerine bunu belirtir.
extension

WHMCS modules (registrar + dedicated servers)

hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 dosya · v1.0.0

downloadİndir

WordPress eklentisi — HostiGuard Connector

v1.0.0 · WordPress 5.8+ · PHP 7.4+

HostiGuard alan adlarını ve özel sunucularını kendi WordPress sitenizden satın. WooCommerce olmadan (ziyaretçiler siparişi tamamlamak için HostiGuard'a yönlendirilir) veya WooCommerce ile (ödeme mağazanızda size yapılır, eklenti ödemeden sonra HostiGuard'da hazırlar) çalışır.

Ne yapar

  • check_circle[hostiguard_domain_search] — alternatif uzantılarla canlı uygunluk ve fiyat.
  • check_circle[hostiguard_domain_pricing] ve [hostiguard_server_plans] — API'den beslenen, önbelleğe alınmış tablolar ve kartlar.
  • check_circleWooCommerce: bir alan adı canlı fiyattan sepete eklenir; ödemeden sonra anahtarınız üzerinden kaydedilir.
  • check_circleHerhangi bir WooCommerce ürününü bir HostiGuard sunucu paketiyle eşleyin (Ürün verileri → HostiGuard sekmesi); ödendiğinde sipariş verilir.
  • check_circleSonuçlar ve hatalar sipariş notlarında, Sipariş işlemleri'nden yeniden deneme, ayarlar sayfası bağlantıyı ve bakiyeyi gösterir.

Kurulum

  1. Aşağıdaki zip dosyasını indirin; WordPress → Eklentiler → Yeni ekle → Eklenti yükle → Etkinleştir.
  2. Ayarlar → HostiGuard: HostiGuard URL'nizi ve API anahtarınızı girin. Sayfa bağlantıyı onaylar, bakiyenizi ve anahtar modunu gösterir.
  3. [hostiguard_domain_search] (ve diğer kısa kodları) herhangi bir sayfaya koyun.
  4. WooCommerce (isteğe bağlı): "Alan adı kaydı" adlı basit bir ürün oluşturun, ayarlarda seçin ve Kayıt'ı WooCommerce moduna alın.
  5. Sunucu satmak için: bir ürünü düzenleyin → Ürün verileri → HostiGuard → paketi ve dönemi seçin.

Kısa kodlar

[hostiguard_domain_search]Canlı fiyatlı alan adı arama. Öznitelikler: tlds="com,net,org", placeholder, button.
[hostiguard_domain_pricing]Uzantı bazında fiyat tablosu. Öznitelikler: sınırlamak için tlds, columns="registration,renewal,transfer".
[hostiguard_server_plans]Özel sunucu paket kartları. Öznitelikler: cycle, button, link.
Bilmekte fayda var: eklenti, HostiGuard'da yalnızca sipariş ödendikten sonra hazırlama yapar; cüzdan bakiyenizi beklediğiniz siparişlerin üzerinde tutun. Yenilemeler, bitiş tarihinde HostiGuard hesabınıza faturalandırılır.

İndirmeler

Her iki paket de HostiGuard'ın bu sürümüyle gelen kodun aynısından oluşturulur; bu nedenle yukarıda belgelenen API ile her zaman uyumludur.

extension

WHMCS modules (registrar + dedicated servers)

hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 dosya · v1.0.0

downloadİndir
widgets

WordPress plugin (HostiGuard Connector)

hostiguard-connector-1.0.0.zip · 20 KB · 9 dosya · v1.0.0

downloadİndir
Sürümleme: modüller API'yi takip eder. Bir uç nokta değiştiğinde veya yeni bir uç nokta eklendiğinde, WHMCS modülleri ve WordPress eklentisi güncellenir ve yeni bir sürüm numarasıyla burada yeniden yayınlanır — bir API güncellemesinden sonra yeniden indirin.

Değişiklik günlüğü

  • new_releasesv1.0.0 — birleşik belgelerin, WHMCS kayıt firması + hazırlama modüllerinin ve WordPress Connector eklentisinin ilk sürümü (API v1).
HostiGuard

Yeni bölümünüz burada başlıyor.

İşinizi büyümek için tasarlanmış hostingle güçlendirin.

speedNVMe SSD depolama lockÜcretsiz SSL verified_user14 gün para iade support_agent7/24 destek
workspace_premiumOrtaklar ve Ödüller

Bizi bağımsız platformlarda kontrol edin

Bir web hosting dizini, gerçek müşterilerden yorumlar ve Dun & Bradstreet tarafından doğrulanmış bir şirket kimliği. Hepsi herkese açık, hepsi bizden bağımsız.

Ortakları ve ödülleri görarrow_forward