# कुंजी का दायरा

## प्रोजेक्ट की पाबंदी

प्रोजेक्ट (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` के साथ ठुकरा दी जाती है।

## पाबंदियों का मेल

प्रोजेक्ट और दायरे की पाबंदियाँ साथ काम करती हैं। जैसे, अगर कुंजी इनवॉइस मेथड तक सीमित है और किसी ख़ास प्रोजेक्ट से बँधी है, तो:

* सिर्फ़ इनवॉइस मेथड उपलब्ध हैं
* डेटा सिर्फ़ बताए गए प्रोजेक्ट तक छना हुआ है
* भुगतानों या आँकड़ों के अनुरोध ठुकरा दिए जाते हैं
* दूसरे प्रोजेक्ट के डेटा के अनुरोध ठुकरा दिए जाते हैं