Geliştirici API’si
Sunucularınızı, hostingi, alan adlarını, faturalandırmayı ve destek taleplerini programatik olarak okuyun. Tüm uç noktalar kapsam denetimli bir API anahtarıyla korunur.
https://api.444host.com/v1Authorization: Bearer h444_…AI bağlantısı (MCP)
Claude ve diğer MCP destekli araçları doğrudan hesabınıza bağlayın. API anahtarınızı taşıyıcı (Bearer) olarak kullanır; tüm araçlar anahtarın kapsamlarıyla sınırlıdır.
https://api.444host.com/mcpclaude mcp add --transport http 444host https://api.444host.com/mcp \ --header "Authorization: Bearer h444_…"
42 araç: sipariş (cüzdandan gerçek satın alma, çift onaylı), VPS (ters DNS dahil), hosting, alan adları, faturalandırma, destek ve webhook’lar. API anahtarı oluşturun →
OAuth destekleyen istemciler anahtar yapıştırmadan bağlanabilir — tarayıcıda onaylarsınız (RFC 8628 cihaz kodu akışı; AS metadata: api.444host.com/.well-known/oauth-authorization-server). Bağlı uygulamaları API Anahtarları sayfasından iptal edebilirsiniz.
Yerel/stdio çalıştırma: H444_API_KEY=h444_… npx -y @otwa/444host-mcp · GitHub · npm
Hızlı başlangıç
Panelden bir API anahtarı oluşturun (Hesap → API Anahtarları), sonra:
curl -H "Authorization: Bearer h444_…" https://api.444host.com/v1/account
Hız limiti: anahtar başına 120 istek/dakika. Yanıtlar X-RateLimit-* başlıkları taşır.
Uç noktalar
Account
/v1/accountaccount:readReturns the authenticated account profile and wallet balance.
{
"id": "9032ffac-…",
"email": "you@example.com",
"first_name": "Jane",
"last_name": "Doe",
"account_type": "individual",
"language": "en",
"email_verified": true,
"balance_usd_cents": 1250,
"created_at": "2026-01-01T00:00:00.000Z"
}Catalogue & ordering
/v1/productsaccount:readOrderable VPS and hosting plans with retail price and YOUR effective price (reseller discount applied when your account has one).
[
{
"slug": "vps-2",
"category": "vps",
"name_en": "VPS 2",
"retail_monthly_usd_cents": 1200,
"your_monthly_usd_cents": 960,
"specs": { "vcpu": 2, "ram_mb": 4096, "disk_gb": 60 }
}
]/v1/os-templatesvps:readInstallable OS templates for VPS orders and reinstalls (Linux only).
/v1/vpsorders:writeAtomic: debits your wallet at your effective price, issues a paid receipt, and provisions. Provisioning failure auto-refunds. Send an Idempotency-Key so a retried request can't order twice. Returns the server AND its initial root password (shown once).
{ "plan_slug": "vps-2", "label": "web-1", "hostname": "web-1", "os_family": "ubuntu", "os_template": "ubuntu-22.04" }/v1/hostingorders:writeSame atomic debit/refund contract. Returns the account AND its SFTP/DB passwords (shown once). `php_version` defaults to 8.3.
{ "plan_slug": "hosting-starter", "domain": "example.com", "username": "examplecom" }VPS
/v1/vpsvps:readEvery VPS on the account, with live status and plan specs.
/v1/vps/:idvps:readServer detail (no credentials, no internal provisioning data).
/v1/vps/:id/statsvps:readLive CPU / memory / network / disk usage.
/v1/vps/:id/ipsvps:readEvery IP on the server with its current PTR record. `zoneHosted: false` means the reverse zone is not on our DNS.
[
{
"ip": "46.31.78.56",
"primary": true,
"gateway": "46.31.78.1",
"netmask": "255.255.255.0",
"ptr": "mail.example.com",
"zoneHosted": true
}
]/v1/vps/all-ipsvps:readEvery IP across all your servers, grouped per server, with PTR records — the API form of the dashboard Reverse DNS page.
/v1/vps/:id/power/:actionvps:writePower the server start, stop, or reboot. `:action` ∈ {start,stop,reboot}.
/v1/vps/:id/labelvps:writeChange the display label.
{ "label": "web-prod-1" }/v1/vps/:id/ips/:ip/ptrvps:writePoint the IP's PTR record at a hostname (e.g. `mail.example.com`). Idempotent upsert.
{ "hostname": "mail.example.com" }/v1/vps/:id/ips/:ip/ptrvps:writeRemove the PTR record for the IP.
/v1/vps/:id/reinstallvps:destroyDESTRUCTIVE — wipe the disk and rebuild from an OS template. Honours an optional Idempotency-Key header.
{ "os": "ubuntu", "osTemplate": "ubuntu-22.04" }/v1/vps/:idvps:destroyDESTRUCTIVE — permanently terminate the server.
Hosting
/v1/hostinghosting:readWeb-hosting accounts with status, quota, usage and connection hosts. Passwords are never returned on the API.
/v1/hosting/:idhosting:readHosting account detail.
/v1/hosting/:id/suspendhosting:writeSuspend the account (site + databases stop serving). Reversible with unsuspend.
/v1/hosting/:id/unsuspendhosting:writeLift a suspension and restore service.
/v1/hosting/:idhosting:destroyDESTRUCTIVE — permanently removes the site, databases, and mail; the username becomes reusable.
/v1/hosting/:id/phphosting:writeSwitch the account's PHP-FPM version. `php_version` ∈ {7.4, 8.1, 8.3}.
{ "php_version": "8.3" }/v1/hosting/:id/ssl/retryhosting:writeRetry the Let's Encrypt certificate issue for the account's domain now.
Domains
/v1/domainsdomains:readRegistered domains with status, nameservers and expiry.
/v1/domains/:iddomains:readDomain detail.
/v1/domains/:iddomains:writeUpdate auto-renew, transfer lock, WHOIS privacy, or nameservers. Changes are pushed to the registry and rolled back if the push fails.
{ "auto_renew": true, "nameservers": ["ns1.example.com","ns2.example.com"] }Billing
/v1/billing/invoicesbilling:readYour invoices, newest first.
/v1/billing/invoices/:idbilling:readSingle invoice with line items and payment transactions.
/v1/billing/walletbilling:readPrepaid wallet balance (USD cents).
/v1/billing/wallet/transactionsbilling:readRecent wallet activity. Query: limit (max 200).
Support tickets
/v1/ticketstickets:readYour support tickets, newest first.
/v1/tickets/:idtickets:readTicket detail with the message thread.
/v1/ticketstickets:writeOpen a support ticket. Honours an optional Idempotency-Key header so a retried request doesn't open a duplicate.
{ "subject": "Mail deliverability", "message": "Our PTR record is set but…", "priority": "medium", "department": "technical" }/v1/tickets/:id/replytickets:writePost a customer reply. Re-opens a resolved/closed ticket.
{ "body": "Thanks — that fixed it." }/v1/tickets/:id/closetickets:writeClose the ticket. Idempotent.
Webhooks
/v1/webhookswebhooks:readYour webhook subscriptions (secrets masked).
/v1/webhookswebhooks:writeSubscribe an HTTPS URL to events. The signing secret is returned ONCE in this response.
{ "url": "https://example.com/hooks/444host", "events": ["vps.power.changed", "ticket.replied"] }/v1/webhooks/:idwebhooks:readSubscription detail (secret masked).
/v1/webhooks/:idwebhooks:writeChange url, events, description, or pause/resume via `is_active`.
{ "is_active": false }/v1/webhooks/:idwebhooks:writeRemove the subscription and stop deliveries.
/v1/webhooks/:id/rotate-secretwebhooks:writeIssue a new signing secret (returned ONCE). The old secret stops signing immediately.
/v1/webhooks/:id/deliverieswebhooks:readRecent delivery attempts with status, duration, and errors. Query: limit (max 200).
/v1/webhooks/:id/deliveries/:deliveryId/redeliverwebhooks:writeClone a past delivery into a fresh attempt.
Webhook olayları
Bir olay gerçekleştiğinde URL’nize imzalı bir POST gönderilir. İmza HMAC-SHA256’dır: X-444host-Signature: t=<ts>,v1=HMAC(secret, "<ts>." + body). Başarısız teslimler üstel geri çekilmeyle yeniden denenir (1dk → 6sa).
vps.createdA server finished ordering/provisioning. Payload: vpsId, label, hostname, planSlug, status, ipv4.
hosting.createdA hosting account was provisioned. Payload: hostingId, username, domain, status.
invoice.paidAn invoice transitioned to paid (any gateway, incl. API orders and renewals). Payload: invoiceId, invoiceNumber, totalUsdCents, currency.
vps.power.changedA power action ran. Payload: vpsId, action (start/stop/reboot).
vps.reinstalledA reinstall ran. Payload: vpsId, os, osTemplate.
vps.ptr.changedA reverse-DNS (PTR) record was set or cleared. Payload: vpsId, ip, ptr (null when cleared).
vps.terminatedA server was terminated. Payload: vpsId.
ticket.createdA support ticket was opened. Payload: ticketId, ticketNumber, subject, status, priority.
ticket.repliedSupport staff replied to your ticket. Payload: ticketId, ticketNumber, subject, status.
Hata kodları
400401403404429500Değişiklik günlüğü
- newModel Context Protocol (MCP) server — connect Claude and other AI tools directly to your account at
https://api.444host.com/mcp(Streamable HTTP) using yourh444_API key as a Bearer token. 42 tools across ordering (real wallet-debited orders with double-confirm), VPS, hosting, domains, billing, tickets and webhooks, scope-gated by the key. - newOAuth 2.0 device-code flow (RFC 8628). Connect AI tools by browser approval instead of pasting a key: the client opens 444host.com/oauth/device, you approve the requested scopes, and it receives a scoped
h444_at_access token (+ single-useh444_rt_refresh, 90-day). Endpoints under/oauth/*with AS metadata at/.well-known/oauth-authorization-server. Revoke connected apps anytime from the API Keys page.
- newHosting lifecycle —
POST /v1/hosting/:id/suspend,POST /v1/hosting/:id/unsuspend(hosting:write) andDELETE /v1/hosting/:id(new opt-inhosting:destroyscope). Together with ordering, the full WHMCS reseller-module verb set: Create / Suspend / Unsuspend / Terminate.
- newAPI ordering —
POST /v1/vpsandPOST /v1/hostingplace real orders: atomic wallet debit, paid receipt, synchronous provisioning, and automatic refund if provisioning fails. Behind the new opt-inorders:writescope (not in default keys — it spends money). Honour Idempotency-Key. - newReseller tier — accounts with a reseller discount see and pay discounted prices on
GET /v1/productsand API orders; renewals inherit the discounted price.GET /v1/accountnow reportsreseller.enabled+discount_pct. Contact support to apply for reseller terms. - newThree more webhook events:
vps.created,hosting.created, andinvoice.paid— everything a billing/provisioning integration needs to sync state. The catalogue is now 9 events.
- newWrite endpoints. vps:write — power start/stop/reboot, rename, set/clear reverse DNS (PTR). vps:destroy (opt-in, not in defaults) — reinstall, terminate. hosting:write — PHP version, SSL re-issue. domains:write — auto-renew / lock / WHOIS / nameservers. tickets:write — open, reply, close.
- newWebhooks — subscribe a URL to account events and receive signed (HMAC-SHA256,
X-444host-Signature) POSTs. Eight endpoints under/v1/webhooksbehind webhooks:read / webhooks:write. Failed deliveries retry with exponential backoff (1m→6h). Events: vps.power.changed, vps.reinstalled, vps.ptr.changed, vps.terminated, ticket.created, ticket.replied. Manage them in the dashboard too (Account → Webhooks). - improvedIdempotency-Key header on reinstall and ticket-create dedups retried requests for 24h.
- newPublic API launch — read-only endpoints for account, VPS (incl. live stats and reverse-DNS/PTR listings), hosting, domains, billing (invoices & wallet) and support tickets. Authenticate with an
h444_…API key minted from the dashboard (Account → API Keys). 120 req/min per key.