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