Panggilan dan Pulangan (REST API)

Terakhir dikemas kini: 31 Mac 2025

Panggilan


Untuk mengakses titik akhir API, panggilan HTTP perlu dihantar ke URL berikut.

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

Untuk panggilan titik akhir peribadi, pengepala HTTP berikut mesti disediakan: apiKey dan
authent. Memasukkan nonce dalam permintaan adalah pilihan.

Contoh

Berikut menunjukkan contoh untuk kemasukan pengepala HTTP dalam Java. Untuk contoh kerja penuh
dalam bahasa pengaturcaraan yang berbeza, lihat Bahagian Contoh Pelaksanaan. 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); di mana apiKey dan authent ditentukan seperti yang diterangkan sebelum ini.


Panggilan titik akhir yang tidak mengubah keadaan pelayan hendaklah dihantar dengan requestType
= GET dan dengan postData dihantar dalam URL. Panggilan titik akhir yang mengubah keadaan pelayan hendaklah dihantar dengan requestType = POST dan dengan postData dihantar dalam URL. Bahagian 4 memperincikan untuk setiap titik akhir requestType yang mana yang patut digunakan.

Pulangan


Pulangan API adalah dalam format JSON. Jika panggilan berjaya, pulangan termasuk maklumat yang diminta
atau maklum balas mengenai tindakan yang diminta. Lihat Bahagian Error! Reference source not found. untuk penerangan pulangan bagi setiap titik akhir.

Jika panggilan berjaya, kunci result dalam struktur akar akan mempunyai nilai success.

Untuk panggilan titik akhir peribadi, pengepala HTTP berikut mesti disediakan: apiKey dan
authent.

Contoh

Berikut menunjukkan pulangan panggilan titik akhir sendorder yang berjaya.
{
"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"
}
}


Ambil perhatian bahawa jika panggilan kembali dengan result sama dengan success, ini hanya bermakna permintaan telah
diterima dan dinilai dengan jayanya. Ini tidak semestinya bermakna operasi yang dikehendaki telah dilaksanakan. Butiran mengenai status operasi dikembalikan dalam kunci status, jika berkenaan.

Contoh

Berikut menunjukkan pulangan panggilan titik akhir sendorder yang berjaya di mana operasi yang dikehendaki tidak dilaksanakan. {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

Perlu bantuan lebih lanjut?