কল এবং রিটার্ন (REST API)

সর্বশেষ আপডেট: ৩১ মার্চ, ২০২৫

কল


API-এর এন্ডপয়েন্ট অ্যাক্সেস করতে, নিম্নলিখিত URL-এ HTTP কল পাঠাতে হবে।

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

প্রাইভেট এন্ডপয়েন্টের কলের জন্য, নিম্নলিখিত HTTP হেডারগুলি প্রদান করতে হবে: apiKey এবং
authent। অনুরোধে nonce অন্তর্ভুক্ত করা ঐচ্ছিক।

উদাহরণ

নিম্নলিখিতটি জাভাতে HTTP হেডার অন্তর্ভুক্ত করার একটি উদাহরণ দেখায়। বিভিন্ন প্রোগ্রামিং ভাষার সম্পূর্ণ
কার্যকরী উদাহরণের জন্য, নমুনা বাস্তবায়ন বিভাগটি দেখুন। 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); যেখানে apiKey এবং authent পূর্বে বর্ণিত হিসাবে নির্ধারিত হয়।


সার্ভারের অবস্থা পরিবর্তন করে না এমন এন্ডপয়েন্টের কলগুলি requestType
= GET এবং URL-এ postData জমা দিয়ে সাবমিট করা উচিত। সার্ভারের অবস্থা পরিবর্তন করে এমন এন্ডপয়েন্টের কলগুলি requestType = POST এবং URL-এ postData জমা দিয়ে সাবমিট করা উচিত। প্রতিটি এন্ডপয়েন্টের জন্য কোন requestType ব্যবহার করা উচিত তা বিভাগ 4-এ বিস্তারিত আছে।

রিটার্ন


API-এর রিটার্ন JSON ফরম্যাটে থাকে। যদি কল সফল হয়, তাহলে রিটার্নে অনুরোধ করা
তথ্য বা অনুরোধ করা অ্যাকশনের উপর ফিডব্যাক অন্তর্ভুক্ত থাকে। প্রতিটি এন্ডপয়েন্টের রিটার্নের বর্ণনার জন্য বিভাগ Error! Reference source not found. দেখুন।

যদি একটি কল সফল হয়, তাহলে রুট স্ট্রাকচারের result কিতে success মান থাকবে।

প্রাইভেট এন্ডপয়েন্টের কলের জন্য, নিম্নলিখিত HTTP হেডারগুলি প্রদান করতে হবে: apiKey এবং
authent।

উদাহরণ

নিম্নলিখিতটি sendorder এন্ডপয়েন্টের একটি সফল কলের রিটার্ন দেখায়।
{
"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"
}
}


মনে রাখবেন যে যদি একটি কল result সফল হিসাবে ফিরে আসে, এর মানে কেবল এই যে অনুরোধটি
সফলভাবে গৃহীত এবং মূল্যায়ন করা হয়েছে। এর মানে এই নয় যে কাঙ্ক্ষিত অপারেশনটি সম্পন্ন হয়েছে। অপারেশনের স্ট্যাটাস সম্পর্কিত বিস্তারিত তথ্য একটি status কিতে ফেরত দেওয়া হয়, যেখানে প্রযোজ্য।

উদাহরণ

নিম্নলিখিতটি sendorder এন্ডপয়েন্টের একটি সফল কলের রিটার্ন দেখায় যেখানে কাঙ্ক্ষিত অপারেশনটি সম্পন্ন হয়নি। {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

আরও সাহায্যের প্রয়োজন?