API अवलोकन

आर्किटेक्चर

TheRPC API, JSON-RPC 2.0 विनिर्देश का पालन करता है और प्रदान करता है:

• मानक HTTP और WebSocket एंडपॉइंट
• API कुंजियों के माध्यम से प्रमाणीकरण
• एकीकृत प्रतिक्रिया प्रारूप
• क्रॉस-नेटवर्क संगतता

संचार प्रोटोकॉल

HTTP एंडपॉइंट

एकल अनुरोधों और सरल एकीकरण के लिए सबसे अच्छा। हमारे HTTP/Curl गाइड में उदाहरण देखें।

https://YOUR_API_ENDPOINT

WebSocket एंडपॉइंट

सदस्यताओं और रीयल-टाइम डेटा के लिए आदर्श। सदस्यता उदाहरणों के लिए eth_subscribe देखें।

wss://YOUR_API_ENDPOINT

JSON-RPC प्रारूप

अनुरोध संरचना

सभी API कॉल JSON-RPC 2.0 प्रारूप का पालन करते हैं। हमारे मूल संचालन गाइड में पूर्ण उदाहरण देखें:

{
	"jsonrpc": "2.0",
	"method": "eth_blockNumber",
	"params": [],
	"id": 1
}

आवश्यक फ़ील्ड:

• jsonrpc: संस्करण पहचानकर्ता (हमेशा "2.0")
• method: कॉल करने के लिए RPC विधि (देखें उपलब्ध विधियां)
• params: पैरामीटर्स की सरणी (खाली हो सकती है)
• id: अनुरोध पहचानकर्ता

प्रतिक्रिया प्रारूप

सभी प्रतिक्रियाएँ एक सुसंगत संरचना का पालन करती हैं:

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": "0x..."
}

या त्रुटि के मामले में:

{
	"jsonrpc": "2.0",
	"id": 1,
	"error": {
		"code": -32600,
		"message": "Invalid Request"
	}
}

प्रमाणीकरण

सभी अनुरोधों के लिए प्राधिकरण हेडर में एक API कुंजी की आवश्यकता होती है। विस्तृत सेटअप के लिए हमारा प्रमाणीकरण गाइड देखें:

Authorization: Bearer YOUR_API_KEY

विधि श्रेणियां

मानक विधियां

• eth_: Ethereum प्रोटोकॉल विधियां (eth_blockNumber, eth_getBalance, आदि)
• net_: नेटवर्क स्थिति विधियां (net_version)
• web3_: Web3 उपयोगिता विधियां (web3_clientVersion)

उन्नत विधियां

• debug_: डीबगिंग क्षमताएं (debug_traceTransaction)
• trace_: लेनदेन ट्रेसिंग (trace_transaction)
• txpool_: लेनदेन पूल जानकारी (txpool_status)

त्रुटि नियंत्रण

आम त्रुटि कोड (विस्तृत त्रुटि नियंत्रण रणनीतियों के लिए FAQ देखें):

• -32700: पार्स त्रुटि
• -32600: अमान्य अनुरोध
• -32601: विधि नहीं मिली
• -32602: अमान्य पैरामीटर्स
• -32603: आंतरिक त्रुटि

कार्यान्वयन उदाहरण

व्यावहारिक कार्यान्वयन उदाहरणों के लिए, हमारे भाषा-विशिष्ट गाइड देखें:

• JavaScript/TypeScript गाइड
• Python गाइड
• HTTP/Curl उदाहरण
• हमारे टूल्स और SDK अनुभाग में सभी उपलब्ध SDK देखें

रेट सीमाएँ

अनुरोध सीमाओं और कोटा के बारे में जानकारी के लिए, हमारा रेट सीमाएँ दस्तावेज़ीकरण देखें।

यह भी देखें

• प्रमाणीकरण गाइड - विस्तृत प्रमाणीकरण जानकारी
• उपलब्ध विधियां - पूर्ण विधि सूची
• मूल संचालन - सामान्य उपयोग पैटर्न
• FAQ - सामान्य प्रश्न और उत्तर