इस मसौदे की API

कोई सार्वजनिक आधार URL नहीं है। कॉल इसी मसौदे के होस्ट पर जाती है। यह पैनल खोलने से टोकन नहीं बनता।

सत्र imma_session कुकी या सत्र Bearer है। एजेंट टोकन ग्राहक और इन्वेंटरी लिखने पर अस्वीकृत होते हैं। स्वास्थ्य को सत्र नहीं चाहिए।

संगठन सत्र से आता है। क्लाइंट का संगठन पहचान अनदेखा होता है।

लिखने वाला कुकी सत्र हेडर x-imma-request का मान 1 भेजे। Bearer उसे नहीं लगाता। GET को वह नहीं चाहिए।

ग्राहक GET को customers.read चाहिए। POST को customers.write चाहिए। इन्वेंटरी POST को inventory.adjust चाहिए, जो केवल स्वामी और प्रशासन के पास है। पुस्तकालय को सत्र चाहिए। एजेंट क्षमता को एजेंट टोकन चाहिए और केवल दायरे लौटते हैं।

POST /api/v1/inventory उसी idempotencyKey और उसी विषय पर गिनती दोहराता है। भिन्न विषय के साथ वही कुंजी 409 देती है। ग्राहक बनाने की कोई idempotency कुंजी नहीं।

पुनर्प्राप्ति एक पते पर घंटे में 3 अनुरोध लेती है और यह नहीं बताती कि वह है या नहीं। एजेंट कार्य उस टोकन पर घंटे में 30 पर रुकते हैं। अन्य आरोपित मार्गों की HTTP सीमा नहीं है।

कोई आरोपित मार्ग कॉलबैक दर्ज या ग्रहण नहीं करता। हस्ताक्षर जाँच सर्वर डोमेन में है और यह बटन उसे नहीं खोलता।

सेवा टोकन जारी करना और रद्द करना प्रमाणित स्वामी या प्रशासक माँगता है और उसी संगठन में रहता है। यह शीर्ष टोकन जारी, दिखाता या रद्द नहीं करता। घुमाना लागू नहीं है।

POST /api/v1/agent/jobs jobs.write वाले एजेंट टोकन के लिए आरोपित है। उदाहरण bearer कृत्रिम है, जीवित कुंजी नहीं। यह पैनल टोकन नहीं बनाता।

GET /api/health · डेटाबेस जाँच। कोई सत्र नहीं। कोई कनेक्शन स्ट्रिंग नहीं।
GET /api/v1/health · डेटाबेस और बंद झंडे जाँचता है। कोई सत्र नहीं।
GET /api/v1/openapi · मशीन दस्तावेज़। अधूरा। ऊपर का अंतर देखें।
GET /api/v1/customers · सत्र संगठन के ग्राहक सूचीबद्ध करता है।
POST /api/v1/customers · ग्राहक बनाता है। क्षेत्र code और name। निकाय का organizationId अनदेखा।
POST /api/v1/inventory · गिनती समायोजन। क्षेत्र warehouseId, productId, countedQty, date, idempotencyKey। नीचे के उदाहरण कृत्रिम हैं।
GET /api/v1/library/search · पूछताछ q। ऑफ़लाइन पुस्तकालय। प्रवर्तनीय कानून नहीं।
GET /api/v1/library/citation · पूछताछ q और वैकल्पिक locale। उद्धरण न हो तो त्रुटि कोड।
GET /api/v1/library/coverage · आवरण की गिनती। कानूनी मंजूरी नहीं।
GET /api/v1/agent/capabilities · बुलाने वाले एजेंट टोकन के दायरे लौटाता है। टोकन नहीं बनाता।
GET /api/v1/agent/jobs · jobs.write वाले एजेंट टोकन के लिए स्थानीय कार्य कतार में रखता है। सीमा घंटे में 30 है। सत्र टोकन अस्वीकृत होता है।
POST /api/v1/agent/jobs · jobs.write वाले एजेंट टोकन के लिए स्थानीय कार्य कतार में रखता है। सीमा घंटे में 30 है। सत्र टोकन अस्वीकृत होता है।

कृत्रिम उदाहरण। जीवित क्रेडेंशियल नहीं।

SYNTHETIC
Authorization: Bearer imma_sess_EXAMPLE
x-imma-request: 1
{"code":"C-EXAMPLE","name":"Example","organizationId":"ignored"}
{"warehouseId":"00000000-0000-0000-0000-000000000000","productId":"00000000-0000-0000-0000-000000000000","countedQty":"1","date":"2026-11-08","idempotencyKey":"example-count-1"}

वापस

अपना खाता बनाएँ

अपना संगठन और स्वामी खाता बनाएँ। एक मिनट लगता है, और अंदर जाकर आप अपनी टीम को बुला सकते हैं।

मेरा खाता पहले से है