API, iki Temmuz'da beta aşamasından çıktı. Haziran'da platform revizyonu 5.4 içinde yayınlandı, Şubat'tan itibaren davetli beta olarak sadece dört yüze biraz aşkın hesapla çalıştı ve Nisan'dan beri şekli değişmedi. Sürümlü, belgeli ve panel ile aynı kullanılabilirlik taahhüdüne tabi.
Geç oldu demek kibarlık olur. Nedeni gizemli değil: üç buçuk dakikada sunucu oluşturan bir tedarik sisteminin üzerine oturan bir arayüz, bir döndürücüyü yoklayan bir arayüz olurdu. Önce kuyruğu 2025'te yeniden yazdık ve bu sıralama şanstan değil bilinçli bir tercihti.
Ne yapar
| Grup | Neler yapabilirsiniz | Notlar |
|---|---|---|
| Örnekler (Instances) | Oluşturma, boyutlandırma, yeniden oluşturma, anlık görüntü, geri yükleme, yok etme | Büyütme canlı, küçültme bir yeniden başlatma gerektirir |
| İmajlar | İşletim sistemi kataloğunu listeleme, URL ile özel ISO kaydetme | Özel ISO kurulumları hâlâ manuel ve hâlâ yavaş |
| Ağ | IPv4 ekleme, ters DNS düzenleme, IPv6 /48 talep etme | Yetkilendirilmiş, asla proxy'lenmez |
| Filtreleme | Saldırı olaylarını okuma, DDoS Pro üzerinde katman-7 kuralları gönderme | Temel filtrelemenin yapılandırılacak bir şeyi yok |
| Faturalama | Bakiye okuma, faturaları listeleme, bakiye yükleme faturası açma | Kart alanları yok, çünkü kart yok |
| Olaylar | Olay günlüğünü yoklama veya webhook kaydetme | Hesap başına bir sırla imzalanır |
Her şey HTTPS üzerinden JSON'dur ve panelin size gösterebildiği her nesne API'nin döndürebildiği bir nesnedir. Web arayüzüne ayrılmış bir işlev katmanı yoktur; bu bize maliyeti olan bir sözdür: panel artık sizin kullandığınız aynı genel uç noktaları tüketir, bu yüzden bozuk bir API bozuk bir paneldir ve hemen öğreniriz.
Kimlik doğrulama
Belirteçler panelde oluşturulur, kapsamlandırılır ve yalnızca bir kez gösterilir. Parola kimlik doğrulaması yok, oturum çerezi yok, güvenmek zorunda kalacağımız bir kimlik sağlayıcıya yönlendirme yok – toplamamamak için hatırı sayılır çaba harcadığımız bir şey.
Bir belirteç; okuma, yazma veya faturalama kapsamı, tek bir siteye isteğe bağlı kısıtlama, isteğe bağlı bir örnek listesine kısıtlama ve sizin belirlediğiniz bir son kullanma süresi taşır. Varsayılan altmış gündür. Belirteçler tek tek iptal edilebilir ve iptal, uçta iki saniye içinde etkili olur; bu, üzerinde ne olduğunu bilmeyen birinin bir derleme sunucusunu yeniden oluşturması durumunda kulağa geldiğinden daha önemlidir.
Buradaki bir hesap bir e-posta adresi ve bir parola karması olduğu için getirilecek bir müşteri nesnesi yoktur. API'de ad alanı, adres alanı, şirket alanı ve vergi alanı yoktur, tam olarak kayıt formunun olmamasının nedeni.
Hız sınırları, idempotency, hatalar
Dakikada altı yüz okuma ve altmış yazma, hesap başına değil belirteç başına sayılır; böylece gürültülü bir komut dosyası diğer otomasyonunuzu aç bırakamaz. Sınırlar, başarılı olanlar dahil her yanıtın başlıklarında döndürülür.
Her yazma bir idempotency anahtarı kabul eder. Aynı anahtarla bir oluşturmayı yeniden denerseniz, onun yanında faturalanan ikinci bir örnek yerine orijinal örneği alırsınız. Bu, beta testçilerinin bize en çok teşekkür ettiği tek özelliktir; bu, sektörün geri kalanının sağlama sırasında bir zaman aşımını nasıl ele aldığı hakkında bir şeyler anlatıyor.
Hatalar belgelenmiş bir makine kodu, bir insanın okuyabileceği bir cümle ve bir istek tanımlayıcısıdır. Tanımlayıcıyı bir bilete yapıştırın, destek sizden tekrar üretmenizi istemeden sizin gördüğünüz isteğin aynısını görebilir.
Bilinçli olarak yapmadıkları
- Asla itibari para yok. Faturalama uç noktaları bakiyenizi okur ve bakiye yükleme faturası açar. Mutabakat, ödeme sayfasında açıklandığı gibi OxaPay'de ve seçtiğiniz zincirde kalır.
- Alt hesap veya rol yok. Sürekli talep edildi. İnşa edilmedi, çünkü bariz uygulama kim-kime-çalışıyor yapısını tutmak anlamına gelir ve biz süresi dolan kapsamlı belirteçler göndermeyi tercih ederiz; organizasyon şemanızı kendinize saklayın.
- Otomatik ölçekleme yok. Örnekler gerçek silikon üzerinde özel çekirdeklerdir, sihirle yaratabileceğimiz bir havuz değil. Kendi programınıza göre oluşturabilir ve yok edebilirsiniz; altta elastik bir soyutlama varmış gibi davranmayacağız.
- SDK matrisi yok. Tek referans istemcisi ve sözleşme olarak düz HTTP. Altı yarım bakımlı dil bağlaması, dokümantasyondan daha kötü yaşlanırdı.
Kırılmasını istediğimiz şeyler
Beta, düzeltmeye değer dokuz hata buldu; üçü ilginç bir şekilde bize aitti ve altısı dokümantasyonun yalan söylemesiydi. Onuncuyu bulursanız, test sırasında hız sınırını kötüye kullanmak gayet iyi ve beklenen bir şeydir; destek, ekran görüntüsündense istek tanımlayıcısını tercih eder.
Referans dokümanlarda. Revizyon 5.4'ün değişiklik günlüğü, Şubat ve Nisan arasında şekli değişen yedi uç noktayı listeler ve sürüm bir içinde yapılacak tek kırıcı değişiklik bunlardır.