> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plato.ae/llms.txt
> Use this file to discover all available pages before exploring further.

# İzinler

> Entegrasyonların yalnızca ihtiyaç duydukları şeye erişebilmesi için API anahtarlarını rollerle eşleyin.

API anahtarı, anahtar oluşturulduğunda seçilen rol aracılığıyla çalışır.

Rol gerekli izni içermiyorsa Plato, anahtarın kendisi geçerli olsa bile bir yetkilendirme hatası döndürür.

## Ortak İzin Setleri

Entegrasyon için rol oluştururken bunu başlangıç ​​noktası olarak kullanın.

| API alanı                      | Gerekli erişim                                                |
| ------------------------------ | ------------------------------------------------------------- |
| CMS okuma ve yazma             | CMS uygulama erişimi                                          |
| Connect360 oku                 | `connect360:conversation:read`                                |
| Connect360 gönder veya oluştur | `connect360:conversation:engage`                              |
| Connect360 sil                 | `connect360:conversation:delete`                              |
| Restoran sipariş feed'i        | `restaurant:order:read`                                       |
| Formu okuyun veya gönderin     | Formun sahibi olan çalışma alanına API anahtar erişimi        |
| Menü ürünleri ve kategorileri  | Menü verilerine sahip olan çalışma alanına API tuşuyla erişim |

## Önerilen Kurulum

Entegrasyon türü başına bir rol oluşturun.

Örneğin:

* Yalnızca CMS girişlerini okuyan bir pazarlama sitesi için `Website CMS Reader`.
* Connect360 sohbet mesajları ve ekleri için `Website Chat Connector`.
* Restoran sipariş toplamlarını okuyan bir araç için `Accounting Order Export`.

Bu, her API anahtarının denetlenmesini kolaylaştırır.

## Tam Erişim

`fullAccess` çalışır ancak entegrasyonlar için varsayılan olmamalıdır.

Bunu yalnızca güvenilir bir arka uç gerçekten geniş çalışma alanı erişimine ihtiyaç duyduğunda ve anahtar güvenli bir şekilde saklandığında kullanın.

## İzin Hataları

İzinler eksik olduğunda yanıtlar genellikle aşağıdaki gibi mesajları içerir:

```json theme={null}
{
  "message": "Missing permission: appAccess:CMS"
}
```

veya:

```json theme={null}
{
  "message": "Unauthorized API key permissions."
}
```

Böyle bir durumda yeni bir anahtar oluşturmadan önce API anahtarına eklenen rolü kontrol edin.