API दस्तावेज़ीकरण
BODACC API का तकनीकी दस्तावेज़ीकरण: endpoints, पैरामीटर, उदाहरण और MCP सर्वर।
BODACC API एक मिनट में
BODACC API JSON में बुलेटिन ऑफिशियल देस एनोन्स सिविल्स ए कॉमर्शियल्स में प्रकाशित कानूनी घोषणाओं के साथ-साथ उनमें दिखने वाली कंपनियों और व्यक्तियों को प्रदर्शित करता है। निर्माण, पंजीकरण, बिक्री, परिवर्तन, रद्दीकरण, सामूहिक कार्यवाही, खातों जमा: प्रत्येक घोषणा अपने प्रकाशन के दिन उपलब्ध होती है, उसके मूल पाठ, संबंधित SIREN और उल्लिखित व्यक्तियों के साथ। डेटाबेस 2008 से 5 करोड़ से अधिक घोषणाओं और SIRENE रजिस्टर में पंजीकृत लगभग 3 करोड़ कंपनियों को कवर करता है।
प्रवेश बिंदु
आवश्यकता के मूल को कवर करने के लिए छह पते पर्याप्त हैं। सभी JSON में उत्तर देते हैं और पेजिनेशन के सामान्य पैरामीटर स्वीकार करते हैं: limit और offset।
| पता | यह क्या लौटाता है |
|---|---|
| /api/bodacc/annonces | घोषणाओं की खोज: q, siren, famille, departement, date_debut, date_fin |
| /api/bodacc/entreprises/{siren} | SIREN द्वारा कंपनी प्रोफ़ाइल: पहचान, पता, निदेशक, संबंधित घोषणाएँ |
| /api/bodacc/personnes/{id} | घोषणाओं में उल्लिखित व्यक्ति: भूमिका, कंपनी, घोषणाएँ |
| /api/bodacc/stats | जीवंत काउंटर: कुल घोषणाएँ, परिवार, सबसे पुराना और सबसे नया प्रकाशन |
| /api/bodacc/openapi.json | पूर्ण OpenAPI विनिर्देश: 32 प्रवेश बिंदु, पैरामीटर और स्कीमा |
| /api/bodacc/mcp | MCP सर्वर: वही डेटा, एक एजेंट या AI सहायक के लिए उपकरण के रूप में प्रदर्शित |
प्रमाणीकरण, कोटा और त्रुटियाँ
सार्वजनिक डेटा के लिए किसी कुंजी की आवश्यकता नहीं है: ब्राउज़र या स्क्रिप्ट से कॉल तुरंत काम करता है। कुंजी द्वारा सत्यापन केवल उन प्रवेश बिंदुओं पर लागू होता है जिन्हें इस प्रकार प्रलेखित किया गया है (संवर्धित फ़ील्ड तक पहुँच, उच्च मात्रा, व्यावसायिक उपयोग)। प्रतिक्रियाएँ सामान्य HTTP कोड का पालन करती हैं: परिणाम के लिए 200, जब इकाई मौजूद नहीं है तो 404, जब अनुरोध दर पार हो जाती है तो 429, हमारी ओर से त्रुटि के लिए 5xx। 429 अंतिम इनकार नहीं है: यह केवल धीमा करने का संकेत देता है, और दर कम होते ही सेवा फिर से उत्तर देती है।
एक कॉल, तीन पंक्तियाँ
शुरू करने के लिए कोई SDK स्थापित करने की आवश्यकता नहीं, कोई खाता बनाने की आवश्यकता नहीं। यहाँ एक विभाग में सामूहिक कार्यवाही की घोषणाओं की खोज दी गई है:
curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=75&limit=5"
# réponse : { "total": 1234, "annonces": [ { "id": "A2026...", "dateparution": "2026-10-23",
# "familleavis": "collective", "commercant": "...", "registre": "..." } ] }यह API अतिरिक्त क्या लाता है
तीन अंतर जो इस पर उत्पाद बनाते समय मायने रखते हैं। ताज़गी: BODACC प्रत्येक प्रकाशन दिवस पर अंतर्ग्रहित किया जाता है, सुबह की घोषणा अपने प्रकाशन के एक घंटे के भीतर उपलब्ध होती है, जबकि अधिकांश पुन:उपयोग साप्ताहिक रूप से अद्यतन डेटाबेस प्रदान करते हैं। भाषा: प्रत्येक प्रोफ़ाइल 20 भाषाओं में मौजूद है, जिससे डेटा को स्वयं अनुवाद किए बिना जापानी या अरबी उपयोगकर्ता को सेवा दी जा सकती है। सुसंगतता: घोषणाएँ, कंपनियाँ और निदेशक आपस में जुड़े हुए हैं, जिससे मुक्त पाठ में पाए गए SIREN को मैन्युअल रूप से जोड़ने से बचा जाता है। सार्वजनिक डेटा के लिए पहुँच निःशुल्क है, और MCP सर्वर एक AI एजेंट को कोड की एक पंक्ति लिखे बिना डेटाबेस से पूछताछ करने की अनुमति देता है।
अक्सर पूछे जाने वाले प्रश्न
- क्या BODACC API निःशुल्क है?
- सार्वजनिक डेटा के लिए हाँ: घोषणाएँ, कंपनियाँ, व्यक्ति और काउंटर। सशुल्क ऑफ़र सुविधा और विश्लेषण (मात्रा, अलर्ट, रिपोर्ट, संवर्धित फ़ील्ड तक पहुँच) पर केंद्रित हैं, कभी भी बुलेटिन ऑफिशियल में प्रकाशित घोषणा तक मूल पहुँच पर नहीं।
- डेटा कहाँ से आता है और कितनी बार अद्यतन किया जाता है?
- डायरेक्शन डे ल'इन्फॉर्मेशन लेगाल ए एडमिनिस्ट्रेटिव द्वारा प्रकाशित BODACC से, कंपनियों की पहचान के लिए INSEE के SIRENE रजिस्टर द्वारा पूरक। अंतर्ग्रहण प्रत्येक प्रकाशन दिवस पर चलता है: सुबह की घोषणा एक घंटे के भीतर उपलब्ध होती है, और API द्वारा प्रदर्शित काउंटर प्रत्येक पास पर पुनर्गणना किए जाते हैं।
- प्रतिक्रियाओं का प्रारूप क्या है?
- JSON, UTF-8 में, ISO 8601 प्रारूप में तिथियों के साथ। राशियाँ यूरो में, SIREN बिना रिक्त स्थान के नौ अंकों में। कोई स्वामित्व प्रारूप नहीं, कोई रूपांतरण नहीं।
- क्या अनुरोधों की कोई सीमा है?
- सेवा की सुरक्षा के लिए प्रति पता और प्रति नेटवर्क एक ब्रेक लागू होता है: एक निश्चित दर से अधिक होने पर, प्रतिक्रिया त्रुटि के बजाय एक अस्थायी 429 होती है। एक स्थायी और घोषित उपयोग (पहचाना गया एजेंट, प्रकाशित पता सीमा) पर ब्रेक नहीं लगाया जाता है। विवरण प्रमाणीकरण और सीमाएँ पृष्ठ में दिया गया है।
- क्या मैं किसी लेख या AI उत्तर में BODACC.io के आंकड़ों का हवाला दे सकता हूँ?
- हाँ, और पुराने आंकड़े की नकल करने के बजाय जीवंत काउंटरों का हवाला देना बेहतर है: पता /api/bodacc/stats उस समय का कुल लौटाता है, और फ़ाइल llms.txt एजेंटों को बताती है कि इसे कहाँ खोजना है। पुरानी मात्रा की घोषणा से बचने का यही एकमात्र तरीका है।
और आगे जाना
छह पृष्ठ प्रत्येक भाग का विवरण देते हैं: पहला कॉल, घोषणाएँ, कंपनियाँ, व्यक्ति और निर्देशिका, प्रमाणीकरण और सीमाएँ, आंकड़े। वे शुरू करते समय इसी क्रम में पढ़ने के लिए लिखे गए हैं, और बाद में आवश्यकतानुसार परामर्श के लिए।
Spécification interactive
कोई सवाल?
हमारी टीम आपको जल्दी जवाब देगी। आपकी पूछताछ API श्रेणी के साथ भेजी जाएगी।