API istifadə şərtləri

Son yenilənmə: 6 fevral 2026

1. API girişi

Hosted Cloud API-dən müştəri panelində API açarı yaratmaqla istifadə etmək olar. API girişi üçün aktiv hesab və etibarlı abunəlik tələb olunur.

2. Sorğu limitləri

API istifadəsi aşağıdakı limitlərə tabedir:

  • Standard paket: Saatda 1000 sorğu, gündə 10 000 sorğu
  • Pro paket: Saatda 5000 sorğu, gündə 50 000 sorğu
  • Enterprise: Fərdi limitlər, məsləhətləşmə yolu ilə müəyyən edilir

Limitlər aşıldıqda HTTP 429 xətası qaytarılır. Limitlərin davamlı pozulması API girişinin ləğv edilməsinə səbəb ola bilər.

3. Autentifikasiya və təhlükəsizlik

  • Bütün API sorğuları HTTPS üzərindən göndərilməlidir
  • API açarları məxfi saxlanılmalı və paylaşılmamalıdır
  • Hər hesab üçün maksimum 5 API açarı yaradıla bilər
  • Şübhəli fəaliyyət olduqda açarlar avtomatik deaktiv edilir
  • IP icazə siyahısı funksiyası mövcuddur

4. Dəstəklənən əməliyyatlar

API vasitəsilə mövcud olan əməliyyatlar:

  • Serverin yaradılması, silinməsi, yenidən başladılması
  • Snapşot və ehtiyat nüsxələrin idarə edilməsi
  • Şəbəkə və firewall konfiqurasiyası
  • DNS qeydlərinin idarə edilməsi
  • Hesablaşma və istifadə məlumatı
  • Monitorinq və metriklər

5. API versiyalaşdırılması

API versiyaları URL-də göstərilir (məsələn, /v1/, /v2/). Köhnə versiyalar ən azı 12 ay dəstəklənir. Köhnəlmə barədə bildirişlər 6 ay əvvəldən verilir.

6. Qadağan olunmuş istifadə

  • Avtomatlaşdırılmış spam və ya zərərli əməliyyatlar
  • Sorğu limitlərini keçmək cəhdləri
  • API infrastrukturuna zərər vurmağa yönəlmiş hərəkətlər
  • Əks mühəndislik və API açarlarının paylaşılması

Sənədin sahibi: API Platforması Komandası
Sənədləşmə: api.hosted.cloud/docs
Dəstək: [email protected]