CreateYourVPN Academy
İş ortağı API'si

İş ortağı API'si

İş ortakları için sunucu API'si: müşteri oluşturun, paket tanımlayın ve abonelikleri kendi sitenizden veya botunuzdan yönetin.

İş ortağı API'si, CreateYourVPN üzerinde kendi sitenizi, müşteri panelinizi veya botunuzu oluşturmanızı sağlar. Yalnızca müşteriler, paketler ve abonelikler sunulur; sunucular, düğümler, paneller ve altyapı kimlik bilgileri yanıtlarda asla yer almaz.

Anahtar yalnızca sunucudan sunucuya kullanım içindir. JavaScript'e veya mobil uygulamaya koymayın. Tarayıcıdan geliyormuş gibi görünen istekler 403 browser_forbidden ile reddedilir.

Başlangıç

  1. Panelde Ayarlar → API ve entegrasyonlar bölümünü açın.
  2. En az gerekli yetkilerle bir anahtar oluşturun ve sırrı kopyalayın; yalnızca bir kez gösterilir.
  3. Anahtarı Authorization: Bearer cyv_live_… veya X-API-Key olarak gönderin.
curl https://api.createyourvpn.com/api/v1/partner-api/me \
  -H "Authorization: Bearer cyv_live_<key_id>_<secret>"

Yetkiler: yapılandırma ve konumlar için config:read, müşterileri okumak için users:read, müşteri oluşturmak ve abonelikleri yönetmek için users:write.

Herkese açık sözleşme

Herkese açık Postman koleksiyonu tüm endpointleri, parametreleri, gövdeleri, örnekleri, yetkileri ve hata kodlarını içerir. Backend sözleşmesinden üretildiği için tek teknik referanstır.

Limitler: anahtar başına dakikada 120 istek, GET /users için dakikada 10 istek. grant, rotate ve DELETE bir Idempotency-Key gerektirir; aynı olayın tüm tekrarlarında 24 saat boyunca aynı değeri kullanın.

On this page