एपीआई (API) युक्त अकाउंटिंग सॉफ्टवेयर

Nordlet का हर हिस्सा एक JSON एपीआई के माध्यम से उपलब्ध है, जिसमें एसडीके (SDKs), वेबहुक (webhooks), आइडपोटेंट रीट्राय (idempotent retries) और एआई सहायकों के लिए एक एमसीपी सर्वर (MCP server) शामिल हैं।

एक एपीआई (API - Application Programming Interface) एक प्रोग्राम को दूसरे प्रोग्राम से संवाद करने का माध्यम प्रदान करती है। अकाउंटिंग एपीआई की मदद से आपका अपना सॉफ्टवेयर किसी व्यक्ति को स्क्रीन पर क्लिक किए बिना चालान (invoices) बना सकता है, भुगतानों को दर्ज कर सकता है और रिपोर्ट पढ़ सकता है।

Nordlet एक ऐसा अकाउंटिंग सॉफ्टवेयर है जिसमें एपीआई ही इसका मुख्य प्रवेश द्वार है। वेब ऐप जो कुछ भी करता है, वह सब इसी एक JSON एपीआई के माध्यम से उपलब्ध है। यह पृष्ठ डेवलपर्स और उन लोगों के लिए है जो यह तय करते हैं कि उनका उत्पाद किसके साथ जुड़ेगा।

Nordlet क्या करता है

एक अनुरोध संरचना (One request shape): प्रत्येक कॉल POST /v1/{module}/{resource}/{action} होती है जिसमें एक JSON बॉडी होती है, उदाहरण के लिए sales/invoices/create या bank/transactions/match।
स्कोप (scopes) वाले एपीआई की: प्रत्येक की (key) एक कंपनी से संबंधित होती है और उसमें sales:read या bank:write जैसे स्कोप होते हैं। आवश्यक स्कोप के बिना की (key) का उपयोग करने पर 403 प्रतिक्रिया मिलती है।
राशि टेक्स्ट के रूप में: राशि (amounts) अधिकतम 4 दशमलव स्थानों वाले दशमलव स्ट्रिंग (decimal strings) होती हैं, जो फ़्लोटिंग-पॉइंट नंबर (floating-point numbers) कभी नहीं होतीं, ताकि राउंडिंग के कारण कोई पैसा (cents) कम न हो।
एक त्रुटि प्रारूप (One error format): प्रत्येक त्रुटि में एक कोड, संदेश (message) और अनुरोध आईडी (request id) के साथ एक ही लिफाफा (envelope) होता है।
साझा सूची क्वेरी (Shared list queries): प्रत्येक list कॉल में पेजिंग, छंटनी (sorting) और फ़िल्टर के समान फ़ील्ड होते हैं, और यह कुल योग (totals) लौटा सकती है।
वास्तविक अकाउंटिंग नियम: जर्नल प्रविष्टियाँ संतुलित होनी चाहिए, दस्तावेज़ संख्याओं में कोई अंतराल (gaps) नहीं होना चाहिए, और एक लॉक अकाउंटिंग अवधि 409 प्रतिक्रिया के साथ नई पोस्टिंग को अस्वीकार कर देती है। प्रत्येक परिवर्तन को ऑडिट लॉग (audit log) में लिखा जाता है।

आइडपोटेंसी (idempotency) के साथ सुरक्षित रीट्राय

आपके अनुरोध के प्रोसेस होने के बाद लेकिन आपको उत्तर मिलने से पहले नेटवर्क विफल हो सकता है। ऐसे में दोबारा प्रयास करने पर वही चालान दो बार बन सकता है। आइडपोटेंसी का मतलब है कि एक दोहराए गए अनुरोध का प्रभाव पहले वाले जैसा ही होता है।

डेटा बदलने वाले किसी भी कॉल के साथ Idempotency-Key हेडर भेजें।
एक ही की (key) और एक ही बॉडी के साथ रीट्राय करने पर संग्रहीत उत्तर वापस मिलता है, जिसमें x-idempotent-replay: true होता है।
अलग बॉडी वाली समान की (key) को अस्वीकार कर दिया जाता है।
की (keys) को 24 घंटे के लिए सुरक्षित रखा जाता है।

वेबहुक (Webhooks)

वेबहुक एक ऐसा संदेश है जिसे Nordlet कुछ घटित होने पर (जैसे sale_invoice.paid) आपके सर्वर पर भेजता है।

इवेंट्स को परिवर्तन के साथ उसी डेटाबेस ट्रांजेक्शन में लिखा जाता है, इसलिए रोलबैक किए गए परिवर्तन पर कोई इवेंट नहीं भेजा जाता है।
प्रत्येक डिलीवरी पर आपके सब्सक्रिप्शन सीक्रेट का उपयोग करके HMAC-SHA256 के साथ हस्ताक्षर किए जाते हैं, ताकि आप यह जांच सकें कि यह Nordlet से आई है या नहीं।
विफल डिलीवरी के लिए लगभग 24 घंटे तक पुनः प्रयास किया जाता है। आप इसे हाथ से भी दोबारा भेज सकते हैं।
सब्सक्रिप्शन को Account → Webhooks के तहत या एपीआई के माध्यम से प्रबंधित किया जाता है।

डेवलपर्स के लिए टूल

एपीआई संदर्भ (API reference): ओपनएपीआई (OpenAPI) विवरण से निर्मित एक इंटरैक्टिव एपीआई संदर्भ, साथ ही एक पोस्टमैन (Postman) कलेक्शन।
एसडीके (SDKs): TypeScript, Python, Go, Java, C#, Ruby, PHP, Swift और Rust के लिए टाइप किए गए क्लाइंट, जो उसी विवरण से जनरेट किए जाते हैं। एसडीके गाइड देखें।
एमसीपी सर्वर (MCP server): Claude जैसे एआई सहायक आपकी एपीआई की (key) के साथ एपीआई को खोज और कॉल कर सकते हैं। एमसीपी सर्वर गाइड देखें।
सैंडबॉक्स कंपनियां: एक टेस्ट कंपनी वास्तविक कंपनी की तरह काम करती है, जिसे टेस्ट डेटा के रूप में चिह्नित किया जाता है, और यह केवल प्रशासन के टेस्ट एंडपॉइंट्स पर फाइलिंग और ई-चालान भेजती है।
रेट लिमिट (Rate limit): प्रति एपीआई की प्रति मिनट 300 अनुरोध, उन हेडर्स के साथ जो यह दिखाते हैं कि कितना शेष है।

अक्सर पूछे जाने वाले प्रश्न

मैं एपीआई के माध्यम से क्या कर सकता हूँ?

उत्पाद में सब कुछ: चालान, खरीदारी, जनरल लेज़र (general ledger), बैंक मिलान, स्टॉक, एसेट, पेरोल, रिपोर्ट और देश-विशिष्ट फाइलिंग। आरंभ करने के लिए गाइड चालान से लेकर वैट (VAT) के आंकड़ों तक पूरे चक्र से अवगत कराती है।

क्या मैं अपने खुद के उत्पाद में अकाउंटिंग बना सकता हूँ?

हाँ। Nordlet में प्रत्येक कंपनी की अपनी बही-खाते (books) होते हैं, और आपका सॉफ्टवेयर इसकी एपीआई की के माध्यम से उन पर काम करता है। एपीआई में ऐसा कोई कॉल नहीं है जो पोस्ट की गई जर्नल प्रविष्टि को संपादित या हटा सके। एक सुधार (correction) एक नई प्रविष्टि होती है, जो एक अपरिवर्तनीय लेज़र (immutable ledger) को बनाए रखती है।