Çağrılar ve Dönüşler (REST API)

Son güncelleme: 31 Mar 2025

Çağrılar


API uç noktalarına erişmek için aşağıdaki URL'ye HTTP çağrıları gönderilmesi gerekmektedir.

https://futures.kraken.com/derivatives/api/v3

Özel uç nokta çağrıları için aşağıdaki HTTP başlıkları sağlanmalıdır: apiKey ve
authent. İstekte nonce'un dahil edilmesi isteğe bağlıdır.

Örnek

Aşağıda Java'da HTTP başlıklarının dahil edilmesine ilişkin bir örnek gösterilmektedir. Farklı programlama dillerindeki tam
çalışma örnekleri için Örnek Uygulamalar bölümüne bakın. String url = "https://futures.kraken.com/derivatives/api/v3/sendOrder";
URL obj = new URL(url);
HttpURLConnection con = (HttpURLConnection) obj.openConnection();
...
con.setRequestProperty("APIKey", apiKey);
con.setRequestProperty("Authent", authent); burada apiKey ve authent daha önce açıklandığı gibi belirlenir.


Sunucunun durumunu değiştirmeyen uç nokta çağrıları, requestType
= GET ve postData'nın URL'de gönderilmesiyle yapılmalıdır. Sunucunun durumunu değiştiren uç nokta çağrıları, requestType = POST ve postData'nın URL'de gönderilmesiyle yapılmalıdır. Bölüm 4, her uç nokta için hangi requestType'ın kullanılması gerektiğini detaylandırmaktadır.

Dönüşler


API'nin dönüşleri JSON formatındadır. Çağrı başarılı olursa, dönüş istenen
bilgiyi veya istenen eylemle ilgili geri bildirimi içerir. Her uç nokta için dönüşlerin açıklaması için Bölüm Hata! Referans kaynağı bulunamadı. bölümüne bakın.

Bir çağrı başarılı olursa, kök yapıdaki result anahtarı success değerine sahip olacaktır.

Özel uç nokta çağrıları için aşağıdaki HTTP başlıkları sağlanmalıdır: apiKey ve
authent.

Örnek

Aşağıda sendorder uç noktasının başarılı bir çağrısının dönüşü gösterilmektedir.
{
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"placed",
"order_id":"c18f0c17-9971-40e6-8e5b10df05d422f0"
}
}


Bir çağrının sonucu success olarak dönerse, bu yalnızca isteğin
başarıyla alındığı ve değerlendirildiği anlamına gelir. Bu, istenen işlemin gerçekleştirildiği anlamına gelmez. İşlemin durumuyla ilgili ayrıntılar, uygun olduğunda bir status anahtarında döndürülür.

Örnek

Aşağıda, istenen işlemin gerçekleştirilmediği sendorder uç noktasının başarılı bir çağrısının dönüşü gösterilmektedir. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

Daha fazla yardıma mı ihtiyacınız var?