İlkbyte API Dokümanları
Bu dokümantasyon İlkbyte api kullanımı için yazılmıştır.
Başlarken
API kullanımına başlamadan önce ilk yapmanız gereken Ilkbyte sitesine kayıt olmaktır. Buradan kayıt işlemini gerçekleştirebilirsiniz. Kayıt olduktan sonra önce sol taraftaki menüde bulunan hesabım sekmesinden hesap ayarlarına sayfasına gitmelisiniz. Buradan ulaşabilirsiniz.


Burada bulunan yeni anahtar ekle butonundan yeni bir api key oluşturabilirsiniz.

Açılan pencerede gerekli ayarları yaptıktan sonra oluşan secret key'i saklamanız gerekmektedir. Daha sonra tekrar gösterilmeyecektir.
Kullanım
Yukarıdaki işlemler sırasıyla yapıldıktan sonra API key elde edilmiş olur. Herhangi bir istek yapılırken bu key Query kısmında gönderilir. Aşağıda istek göndermek için birkaç örnek verilmiştir.
PHP
<?php
$curl = curl_init();
$data = [
'access' => 'access_key',
'secret' => 'secret_key'
];
$data = http_build_query($data);
curl_setopt_array($curl, array(
CURLOPT_URL => "https://api.ilkbyte.com?".$data,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_POSTFIELDS => "",
CURLOPT_HTTPHEADER => array(
"accept: application/json"
),
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
GO
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.ilkbyte.com?access=access_key&secret=secret_key"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("accept", "application/json")
req.Header.Add("content-type", "multipart/form-data; boundary=---011000010111000001101001")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
İstek Limitleri
API'yi tüm kullanıcılar için kararlı tutmak amacıyla istekler sınırlandırılır:
| Kapsam | Limit |
|---|---|
| IP adresi başına | Saniyede 20 istek |
| API anahtarı başına | Saniyede 10 istek |
| Sunucu oluşturma ve klonlama (hesap başına) | Aynı anda en fazla 30 kurulum, dakikada en fazla 30 sunucu |
Limit aşıldığında HTTP 429 Too Many Requests döner. Retry-After başlığı, tekrar denemeden önce beklemeniz gereken süreyi saniye olarak verir. Reddedilen istek işleme alınmamıştır; bekledikten sonra aynı isteği tekrar gönderebilirsiniz. Hesabınızda başka bir işlem sürerken gönderilen satın alma, yenileme, silme, oluşturma ve klonlama istekleri de aynı şekilde 429 ile reddedilir.
Çok sayıda hatalı kimlik denemesi yapan IP adresi geçici olarak engellenir.
Limitler değişebilir; uygulamanızı sabit değerlere göre değil Retry-After başlığına göre kurgulayın.