कुंजी का दायरा
प्रोजेक्ट की पाबंदी
प्रोजेक्ट (Project) फ़ील्ड API कुंजी को किसी ख़ास प्रोजेक्ट तक सीमित करता है:
- Any — कुंजी की पहुँच खाते के सभी प्रोजेक्ट तक है
- कोई ख़ास प्रोजेक्ट — कुंजी सिर्फ़ चुने हुए प्रोजेक्ट के डेटा के साथ काम करती है
पाबंदी का बर्ताव मेथड पर निर्भर करता है। सूची वाले मेथड में यह फ़िल्टर है: जवाब सफल होता है, लेकिन उसमें सिर्फ़ उसी प्रोजेक्ट का डेटा होता है। किसी ख़ास इनवॉइस या वॉलेट से जुड़े मेथड में दूसरे प्रोजेक्ट के ऑब्जेक्ट का अनुरोध Restricted project के साथ ठुकरा दिया जाता है।
| मेथड | प्रोजेक्ट तक सीमित कुंजी |
|---|---|
billing/balances | खाते के स्तर का डेटा; पाबंदी लागू नहीं होती |
billing/history | प्रोजेक्ट के ऑपरेशन और साथ में खाते के स्तर के ऑपरेशन — टॉप-अप और बोनस |
billing/tariffs | शुल्क दर और कारोबार सिर्फ़ कुंजी के प्रोजेक्ट के लिए |
invoices/list | नतीजे सिर्फ़ कुंजी के प्रोजेक्ट के |
payments/list | नतीजे सिर्फ़ कुंजी के प्रोजेक्ट के |
statistics/invoices | गणना सिर्फ़ कुंजी के प्रोजेक्ट पर |
statistics/payments | गणना सिर्फ़ कुंजी के प्रोजेक्ट के इनवॉइस पर |
invoices/create | अनुरोध का projectId कुंजी के प्रोजेक्ट से मेल खाना चाहिए |
invoices/cancel | दूसरे प्रोजेक्ट का इनवॉइस पहुँच से बाहर है |
invoices/bindPayment | दूसरे प्रोजेक्ट का इनवॉइस पहुँच से बाहर है |
दायरे की पाबंदी
दायरा तय करता है कि कुंजी कौन से API मेथड इस्तेमाल कर सकती है। यह अनिवार्य, बहु-चयन फ़ील्ड है।
कुंजी के दायरे से बाहर के मेथड की कॉल Restricted scope के साथ ठुकरा दी जाती है।
पाबंदियों का मेल
प्रोजेक्ट और दायरे की पाबंदियाँ साथ काम करती हैं। जैसे, अगर कुंजी इनवॉइस मेथड तक सीमित है और किसी ख़ास प्रोजेक्ट से बँधी है, तो:
- सिर्फ़ इनवॉइस मेथड उपलब्ध हैं
- डेटा सिर्फ़ बताए गए प्रोजेक्ट तक छना हुआ है
- भुगतानों या आँकड़ों के अनुरोध ठुकरा दिए जाते हैं
- दूसरे प्रोजेक्ट के डेटा के अनुरोध ठुकरा दिए जाते हैं