WWebhostric/ API
API v2 · çalışıyor

Bir anahtar.
Tam web altyapısı.

Alan adı sorgulama ve satın alma, site üretme, veritabanı, dosya deposu, SSL ve yayınlama işlemlerini REST veya MCP üzerinden yönetin.

Kişisel API anahtarı üret →OpenAPI JSONAI talimatı
BASE URLhttps://webhostric.com.tr/v1

Hızlı başlangıç

Google hesabıyla üretilen kişisel anahtar, yalnızca o hesaba ait bakiye ve kaynaklara erişir.

1

Anahtarı üret

Ana sayfadaki düğmeyle Google girişi yapın. wk_user_… anahtarı yalnızca üretildiği anda tam görünür.

2

Yapay zekâya ver

Kopyala düğmesi anahtarla birlikte bu dokümantasyon adresini de panoya ekler. Link ekranda anahtarın yanında gösterilmez.

3

İsteğinizi tarif edin

Site adı, alan adı, tasarım, sayfalar ve gerekli veritabanı özelliklerini doğal dille anlatın.

4

Kontrol ederek yayınlayın

AI bakiyeyi ve kesin teklifi kontrol eder. Ücretli işlem ancak yeterli bakiye ve sizin ayrı onayınızla tamamlanır.

Kimlik doğrulama

Anahtarı URL'ye eklemeyin. Her istekte Bearer başlığı kullanın.

HTTP başlığı
Authorization: Bearer <API_KEY>
Content-Type: application/json
İlk çağrı: GET /v1/meBakiye, doğrulama durumu, bekleyen siparişler, yetenekler ve makinece okunabilir siteLaunch kararını döndürür.

Site kurulum akışı

Hesapta herhangi bir tutarın bulunması tek başına yeterli değildir. Kesin teklifin sufficientBalance alanı esas alınır.

1

Hesabı ve ihtiyacı oku

GET /v1/me; ardından site adı, tasarım ve hedef alan adını netleştir.

2

Alan adını sorgula

POST /v1/domain/check. Yalnızca purchasable=true sonucu için ilerle.

3

Ücretsiz teklif oluştur

POST /v1/order/quote kesin tutarı, eksik bakiyeyi, yükleme ve onay bağlantılarını döndürür; ücret almaz.

4

Bakiye kararını uygula

sufficientBalance=false ise dur, shortfall ve topUpUrl ver. Kullanıcı yükledikten sonra hesabı ve teklifi yeniden kontrol et.

5

Onaydan sonra tamamla

Bakiye yeterliyse tam alan adı, USD tutarı ve approveUrl göster. Kullanıcı onayladıktan sonra aynı Idempotency-Key ile execute et.

Bakiye yoksaÜcretsiz proje veya tasarım önizlemesi hazırlanabilir; fakat satın alınmış alan adı ya da tamamlanmış ücretli canlı yayın gibi gösterilemez.

AI platformlarına bağla

API anahtarını normal sohbet mesajına yapıştırmak, o sohbet ortamına otomatik ağ veya araç yetkisi vermez. Webhostric sunucusu tüm originlere ve büyük AI tarayıcılarına açıktır; istemcide aşağıdaki MCP ya da OpenAPI bağlantısı kurulmalıdır.

Önerilen bağlantıUzak MCP adresi: https://webhostric.com.tr/mcp. OAuth ile Google hesabınıza bağlanın; anahtarı sohbet geçmişine yazmanız gerekmez.

Claude Önerilen: MCP

Claude, Cowork ve Claude Desktop özel uzak MCP bağlayıcısını destekler.

  1. Customize → Connectors bölümüne gidin.
  2. + Add → Add custom connector seçin.
  3. MCP URL'yi ekleyin.
  4. Sign in now ve OAuth ile bağlanın.
Resmî Claude adımları

ChatGPT Önerilen: MCP

Webhostric'i özel MCP sunucusu olarak ChatGPT Plugins'e ekleyin.

  1. ChatGPT Plugins sayfasını açın.
  2. + → Add custom MCP server seçin.
  3. Bağlantıya /mcp adresini yazın.
  4. Kimlik doğrulamayı onaylayıp Create as a plugin seçin.
Resmî OpenAI adımları

Gemini MCP / REST

Kullandığınız Gemini istemcisi uzak MCP sunucusu eklemeyi destekliyorsa aynı MCP adresini ve OAuth'u kullanın. Sade Gemini sohbetinde özel araç ekleme seçeneği yoksa OpenAPI belgesini bir function-calling/agent uygulamasına tanıtın.

Grok MCP / REST

Kullandığınız Grok istemcisinde özel MCP veya araç bağlantısı varsa MCP adresini ekleyin. Yoksa yalnızca anahtarı sohbete yapıştırmak yeterli olmaz; Grok API/function-calling katmanından Webhostric OpenAPI uçlarını çağırın.

REST örneği

Önce hesap durumunu okuyun, sonra alan adını sorgulayın.

cURL
GET https://webhostric.com.tr/v1/me
Authorization: Bearer <API_KEY>
Alan adı sorgusu
POST https://webhostric.com.tr/v1/domain/check
Authorization: Bearer <API_KEY>
Content-Type: application/json

{"domain":"ornek.com"}

Temel uçlar

Tam ve her zaman güncel şema için OpenAPI belgesini kullanın.

GET/v1/meHesap, bakiye ve sonraki güvenli adım.
GET/v1/tldsDesteklenen uzantılar ve fiyatlar.
POST/v1/domain/checkAlan adı durumu ve satın alınabilirlik.
POST/v1/order/quoteÜcretsiz kesin teklif, bakiye ve onay bağlantısı.
POST/v1/order/executeOnaylanmış siparişi idempotent biçimde tamamlar.
GET/v1/sitesYalnızca anahtar sahibinin siteleri.
POST/v1/sites/{domain}/editDoğal dille site düzenleme.
POST/v1/projectsVeritabanı ve dosya depolu sunucusuz proje.
GET/v1/toolsTüm araçların adları ve parametreleri.

MCP bağlantısı

ChatGPT, Claude ve uyumlu istemciler aynı yetenekleri Streamable HTTP üzerinden kullanabilir.

MCP URLhttps://webhostric.com.tr/mcp

Kişisel API anahtarını Bearer olarak verin veya OAuth 2.1 + PKCE ile bağlanın. Partner wk_live_ anahtarları MCP'de kabul edilmez.

Hata kodları

401 unauthorizedAnahtar yok, geçersiz veya iptal edilmiş.
402 insufficient_balanceEksik tutarı ve topUpUrl'yi kullanıcıya verin.
403 kyc_requiredYalnızca bu işlem kimlik doğrulaması istiyor.
412 approval_requiredKullanıcı approveUrl üzerinden onay vermeli.
410 approval_expiredTeklif/onay süresi dolmuş; yeniden teklif alın.
422 unsupported_tldUzantı otomatik kayıt için desteklenmiyor.
429 rate_limitedretryAfter süresi kadar bekleyin.
502 provider_errorMüsaitlik bilinmiyor; asla “müsait” demeyin.

Güvenlik kuralları

API anahtarını URL'ye veya loglara yazmayın. Yapay zekâ başka bir hesabın kaynaklarına erişemez. Ücretli her işlem ayrı ve kısa ömürlü kullanıcı onayı ister. Silme işlemlerinden önce açık onay alın. Aynı siparişi tekrar denerken aynı Idempotency-Key değerini kullanın.