कॉल और रिटर्न (REST API)

अंतिम अपडेट: 31 मार्च 2025

कॉल


API के एंडपॉइंट्स तक पहुँचने के लिए, HTTP कॉल को निम्नलिखित URL पर भेजा जाना चाहिए।

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

निजी एंडपॉइंट्स के कॉल के लिए, निम्नलिखित HTTP हेडर प्रदान किए जाने चाहिए: apiKey और
authent। अनुरोध में nonce शामिल करना वैकल्पिक है।

उदाहरण

निम्नलिखित Java में 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 के साथ और postData को URL में सबमिट करके प्रस्तुत किया जाना चाहिए। एंडपॉइंट्स के कॉल जो सर्वर की स्थिति को बदलते हैं, उन्हें requestType = POST के साथ और postData को URL में सबमिट करके प्रस्तुत किया जाना चाहिए। अनुभाग 4 प्रत्येक एंडपॉइंट के लिए बताता है कि किस requestType का उपयोग किया जाना चाहिए।

रिटर्न


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 के साथ success के बराबर आता है, तो इसका मतलब केवल यह है कि अनुरोध सफलतापूर्वक प्राप्त और मूल्यांकित किया गया है। इसका मतलब यह नहीं है कि वांछित ऑपरेशन किया गया है। ऑपरेशन की स्थिति का विवरण एक status कुंजी में लौटाया जाता है, जहाँ लागू हो।

उदाहरण

निम्नलिखित sendorder एंडपॉइंट के एक सफल कॉल का रिटर्न दिखाता है जहाँ वांछित ऑपरेशन नहीं किया गया था। {
"result":"success",
"serverTime":"2016-02-25T09:45:53.818Z",
"sendStatus":{
"receivedTime":"2016-02-25T09:45:53.601Z",
"status":"insufficientAvailableFunds"
}
}

क्या आपको और मदद चाहिए?