hi
फिनटेक

एपीआई प्रलेखन

क्लाइंट साइट, बैक ऑफिस और सभी प्लेटफॉर्म मॉड्यूल एपीआई के माध्यम से डेटाबेस फाइलों के साथ काम करते हैं, न कि सीधे। एपीआई आने वाले डेटा की पहुंच, अखंडता और शुद्धता को नियंत्रित करता है।

सामान्य विवरण

एपीआई कैसे काम करता है?

एपीआई - मंच का प्रमुख नोड

यह दस्तावेज़ निम्नलिखित क्रियाओं के लिए सभी API विधियों का वर्णन करता है:

  • वस्तुओं की सूची प्राप्त करना (सूची विधि)
  • सूची फ़िल्टरिंग (फ़िल्टर डेटा के साथ सूची विधि)
  • किसी वस्तु के बारे में विस्तृत जानकारी प्राप्त करना (शो विधि)
  • ऐड ऑब्जेक्ट फॉर्म के लिए डेटा प्राप्त करना (विधि जोड़ें)
  • डेटा को एक नई वस्तु के रूप में सहेजना (स्टोर विधि)
  • ऑब्जेक्ट अपडेट फॉर्म के लिए डेटा प्राप्त करना (विधि संपादित करें)
  • अद्यतन वस्तु के डेटा को सहेजना (अद्यतन विधि)

आईपी पते द्वारा जाँच

API केवल IP पतों की सीमित सूची से अनुरोध स्वीकार करता है (उदाहरण के लिए, किसी ग्राहक की खाता साइट या बैक ऑफिस साइट से)।

किसी आईपी पते से एपीआई के लिए कोई भी अनुरोध जो अनुमत सूची में नहीं है, उसे अस्वीकार कर दिया जाएगा।

यह एपीआई पर डीडीओएस हमलों को रोकने के लिए किया जाता है, अनुरोधों और हैकर प्रयोगों को गलत साबित करने का प्रयास करता है।

उपयोगकर्ता हमेशा प्लेटफॉर्म की सार्वजनिक साइट (ग्राहक कार्यालय या बैक ऑफिस) तक पहुंचते हैं, और यह साइट स्वयं प्लेटफॉर्म के एपीआई से आवश्यक डेटा का अनुरोध करती है। चूंकि साइट का IP पता निश्चित है, यह अनुमत सूची में होगा।

यूआरएल और विधि

सभी API अनुरोध निम्न HTTP विधियों का उपयोग करके किए जाते हैं:

  • GET सूची, दिखाने, जोड़ने और संपादित करने के लिए
  • POST दुकान के लिए
  • PUT अद्यतन के लिए
  • DELETE हटाने के लिए

एपीआई के प्रत्येक अनुभाग में एक यूआरएल होता है जिसमें प्रासंगिक डेटा प्राप्त करने के लिए अनुरोध किया जाता है।

प्रत्येक URL के सामने HTTP अनुरोध विधि निर्दिष्ट की जाती है।

एक अनुरोध भेजा जा रहा है

प्रत्येक एपीआई अनुरोध में हमेशा 4 चर होने चाहिए:

  1. data (एपीआई के लिए डेटा सरणी के साथ जेसन स्ट्रिंग)
  2. user (वर्तमान उपयोगकर्ता के बारे में डेटा की एक सरणी के साथ जेसन स्ट्रिंग)
  3. time (UTC समय क्षेत्र में वर्तमान समय)
  4. hash (हैश के रूप में डिजिटल हस्ताक्षर यह सत्यापित करने के लिए कि एपीआई के लिए अनुरोध निश्चित रूप से अधिकृत स्रोत से है)

एपीआई से प्रतिक्रिया प्राप्त करना

यदि अनुरोध सफल होता है, तो एपीआई हमेशा दो चर लौटाता है:

  1. status = true (सफलता की स्थिति)
  2. data (एपीआई से डेटा सरणी के साथ जेसन स्ट्रिंग)

यदि अनुरोध विफल रहता है, तो एपीआई चर दिखाता है:

  1. status = false (त्रुटि स्थिति)
  2. error (त्रुटि का वर्णन करने वाला पाठ स्ट्रिंग)

अंगुली का हस्ताक्षर

प्रत्येक एपीआई अनुरोध में एक हैश चर होना चाहिए जो अनुरोध का डिजिटल हस्ताक्षर है।

hash = md5($json . $time . $salt)

  • md5, sha256, bcrypt — उपलब्ध एन्क्रिप्शन एल्गोरिदम
  • $json — अनुरोध डेटा के साथ जेसन स्ट्रिंग
  • $time — "DD.MM.YYYY HH:MM:SS" प्रारूप में समय
  • $salt — प्लेटफार्म एपीआई के लिए निश्चित अद्वितीय मूल्य ("नमक")

फिनटेक

दस्तावेज़ में वास्तविक API अनुरोधों के उदाहरण हैं