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.
https://hostiguard.com/api/v1
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:
Hesap, alan adı fiyatları ve uygunluk, kayıt, özel sunucu paketleri ve siparişleri, sipariş sorgulama, alt müşteriler.
Etkin bir SMS hizmetinin anahtarıyla kendi uygulamanızdan kısa mesaj gönderin.
Faturaların otomatik olarak ödendi işaretlenmesi için her ödeme ağ geçidinin çağırması gereken geri çağırma URL'leri.
Kayıt firması modülü (alan adları) ve hazırlama modülü (özel sunucular) — HostiGuard'ı WHMCS içinde yeniden satın.
Kendi sitenizde alan adı arama, fiyat tabloları, sunucu paketleri ve WooCommerce ile hazırlama.
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.
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.
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ınHer 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
}
}
| 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 |
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 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
/account
lockYetki: account
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"
]
}
}
}
/domains/pricing
lockYetki: domains
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
}
]
}
}
/domains/check
lockYetki: domains
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"
}
}
}
/domains
lockYetki: domains
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
}
]
}
}
/domains/register
lockYetki: domains
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
}
}
/servers/plans
lockYetki: servers
Ö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"
}
]
}
}
/servers
lockYetki: servers
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
}
]
}
}
/servers/order
lockYetki: servers
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
}
}
/orders/{id}
lockYetki: account
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"
}
]
}
}
/clients
lockYetki: clients
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"
}
]
}
}
/clients
lockYetki: clients
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ı |
| 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"
}
}
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
https://hostiguard.com/api/sms/send
Parametreler
| to | zorunlu | Uluslararası biçimde hedef numara (+1234567890). |
| message | zorunlu | Mesaj metni. |
| api_secret | isteğ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ı
| 401 | Eksik / geçersiz anahtar veya yanlış api_secret |
| 400 | "to" veya "message" eksik |
| 402 | Pakette SMS hacmi kalmadı |
| 403 | SMS hizmeti etkin değil veya askıda |
Anahtarlar ve secret'lar şurada yönetilir: Dashboard → SMS
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çidi | Webhook 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.
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
Kurulum
hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 dosya · v1.0.0
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
Kurulum
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. |
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.
hostiguard-whmcs-modules-1.0.0.zip · 15 KB · 6 dosya · v1.0.0
hostiguard-connector-1.0.0.zip · 20 KB · 9 dosya · v1.0.0
İşinizi büyümek için tasarlanmış hostingle güçlendirin.
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.