# ขอบเขตของคีย์

## การจำกัดโปรเจกต์

ฟิลด์โปรเจกต์ (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`

## การใช้ข้อจำกัดร่วมกัน

ข้อจำกัดโปรเจกต์และขอบเขตทำงานร่วมกัน ตัวอย่างเช่น หากคีย์ถูกจำกัดไว้ที่เมธอดใบแจ้งหนี้และผูกกับโปรเจกต์ที่กำหนด ผลคือ:

* ใช้ได้เฉพาะเมธอดใบแจ้งหนี้
* ข้อมูลถูกกรองเหลือเฉพาะโปรเจกต์ที่ระบุ
* คำขอการชำระเงินหรือสถิติถูกปฏิเสธ
* คำขอข้อมูลของโปรเจกต์อื่นถูกปฏิเสธ