YYYY-MM-DD) का उपयोग करती है। प्रकाशित OpenAPI दस्तावेज़ अपना कॉन्ट्रैक्ट संस्करण info["x-contract-version"] के रूप में शामिल करता है, और प्रत्येक ऑपरेशन अपना लाइफ़साइकल चरण
x-lifecycle-stage (preview, compatibility या ga) के रूप में घोषित करता है।
- वर्तमान स्पेसिफ़िकेशन हमेशा
/v1-reference/openapi-v1.jsonपर उपलब्ध रहता है। - संस्करण-आधारित संदर्भ स्नैपशॉट
/v1-reference/openapi/<version>.jsonपर उपलब्ध हैं, उदाहरण के लिए/v1-reference/openapi/2026-07-01.json।
दस्तावेज़ीकरण अपडेट
2026-08-25 —/v1 गाइड और OpenAPI servers सूची में अब लाइव US और EU क्षेत्रीय होस्ट के नाम दिए गए हैं। यह दस्तावेज़ीकरण से संबंधित स्पष्टीकरण है। कॉन्ट्रैक्ट संस्करण में कोई बदलाव नहीं हुआ है। देखें Regions।
2026-07-01
/v1 Public API इस कॉन्ट्रैक्ट संस्करण को सपोर्ट करती है। इसे Living-Security-Version: 2026-07-01 का उपयोग करके पिन करें, या अपने सर्विस अकाउंट को असाइन किए गए डिफ़ॉल्ट संस्करण का उपयोग करें।
अपने पहले अनुरोध के लिए API quickstart, API कुंजियों और OAuth के लिए Authentication, और सही होस्ट के लिए Regions देखें।
2026-08-05
यह तिथि अलग लीगेसी/api/v1 कम्पैटिबिलिटी कॉन्ट्रैक्ट की पहचान कराती है। यह नई /v1 API के लिए Living-Security-Version मान नहीं है।
- People: संगठन के लोगों को खोजना (
GET /people/search) और किसी व्यक्ति की सदस्यता प्राप्त करना (GET /people/{personId}/membership)। - API access keys: API एक्सेस कुंजियाँ बनाना, सूचीबद्ध करना, रोटेट करना और रद्द करना
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id})।
compatibility लाइफ़साइकल चरण पर प्रकाशित हैं। ऑथेंटिकेशन, पेजिनेशन और त्रुटि प्रबंधन के लिए Public API overview देखें, और यह कॉन्ट्रैक्ट कैसे विकसित होता है, इसके लिए
compatibility and deprecation policy देखें।