वर्कस्पेस
आपका वर्कस्पेस Bird में कार्य की इकाई है। इसमें आपके डोमेन, API keys, भेजे गए संदेश और टीम एक्सेस होते हैं। डैशबोर्ड वर्कस्पेस-प्रथम है, और हर कार्य आपके वर्कस्पेस के अंदर होता है। आपका अकाउंट एक ही क्षेत्र से जुड़ा होता है और इसमें आपकी बिलिंग जानकारी होती है।
क्षेत्र
आपका अकाउंट ठीक एक क्षेत्र से जुड़ा होता है, वर्तमान में us1 (संयुक्त राज्य अमेरिका) या eu1 (यूरोपीय संघ)। क्षेत्र साइनअप के समय चुना जाता है और बदला नहीं जा सकता: आपका डेटा और भेजने का इन्फ्रास्ट्रक्चर वहीं रहता है, और API ट्रैफ़िक उस क्षेत्र के होस्ट https://us1.platform.bird.com या https://eu1.platform.bird.com पर जाता है। क्षेत्र हर API key प्रीफ़िक्स (bk_us1_...) में शामिल होता है, इसलिए अनुरोध स्वयं रूट हो जाते हैं। रूटिंग नियमों और गलत क्षेत्र पर पहुँचने वाले अनुरोध के बारे में Base URLs और क्षेत्र देखें।
अनुरोध आपका वर्कस्पेस कैसे ढूँढता है
Bird का API फ्लैट रूट्स (/v1/email/messages, /v1/sms/messages) का उपयोग करता है, जिनमें पाथ में कोई वर्कस्पेस सेगमेंट नहीं होता। इसके बजाय क्रेडेंशियल कॉन्टेक्स्ट प्रदान करता है: एक API key आपके वर्कस्पेस से बंधी होती है, जो उसके ऑर्गनाइज़ेशन और रीजन को भी निर्धारित करती है, इसलिए एक अनुरोध को key के अलावा किसी और चीज़ की ज़रूरत नहीं होती। यदि कोई अनुरोध अपनी key से विरोधाभासी कॉन्टेक्स्ट निर्दिष्ट करता है, तो उसे चुपचाप पुनर्व्याख्या करने के बजाय विकृत (400) के रूप में अस्वीकार कर दिया जाता है।
अनुरोध को अनुमति दी जाए या नहीं, यह एक अलग प्रश्न है, जिसका उत्तर API keys के लिए key स्कोप और डैशबोर्ड में काम करने वाले लोगों के लिए रोल देते हैं।
अकाउंट बंद करना
अपना अकाउंट बंद करना स्थायी है और जानबूझकर गलती से करना कठिन बनाया गया है। अकाउंट बंद करने की प्रक्रिया मालिक द्वारा अकाउंट सेटिंग्स से शुरू की जाती है और एक पुष्टिकरण ईमेल भेजती है। जब तक आप Bird द्वारा भेजे गए लिंक पर क्लिक करके पुष्टि नहीं करते, कुछ भी नहीं बदलता।
पुष्टि होने के बाद:
- लॉकआउट तुरंत होता है। आपका अकाउंट डैशबोर्ड से गायब हो जाता है, इसकी API keys प्रमाणीकरण बंद कर देती हैं और निरस्त कर दी जाती हैं, भेजना रुक जाता है, और कोई भी सक्रिय सदस्यता रद्द हो जाती है।
- 7 दिन की ग्रेस विंडो मिलती है। डेटा, कॉन्फ़िगरेशन और टीम सदस्यताएँ बिना छेड़छाड़ के बनी रहती हैं। बंद करने की ईमेल में एक रद्द करने का लिंक होता है, और विंडो के अंदर उस पर क्लिक करने से एक्सेस बहाल हो जाता है। API keys को छोड़कर सब कुछ वापस आ जाता है, जो लॉकआउट के समय निरस्त कर दी गई थीं और दोबारा जारी करनी होंगी।
- उसके बाद पर्ज अपरिवर्तनीय है। विंडो के बाद, क्लीनअप चलता है और सब कुछ हटा देता है: डोमेन, सप्रेशन, webhook एंडपॉइंट, टेम्प्लेट, सदस्यताएँ, डेटा। पर्ज शुरू होने के बाद कुछ भी पुनर्प्राप्त नहीं किया जा सकता।
अगले कदम
- प्रमाणीकरण और API keys: keys वर्कस्पेस से कैसे जुड़ती हैं
- उपयोगकर्ता, टीम और रोल: वर्कस्पेस रोल और एक्सेस नियंत्रण, बिलिंग के लिए अकाउंट-स्तरीय रोल सहित
- Base URLs और क्षेत्र: क्षेत्रीय होस्ट और रूटिंग
संबंधित संसाधन
इस विषय के लिए डॉक्यूमेंटेशन, गाइड और उदाहरणों के साथ आगे बढ़ें। संसाधन अंग्रेज़ी में हैं।