> ## 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.

# Ekler

> Connect360 mesajları için dosyaları yükleyin ve özel ek varlıklarını okuyun.

Bir sohbet mesajının resim, PDF, makbuz veya başka bir dosyaya ihtiyacı olduğunda ekleri kullanın.

## Ekleri Yükle

```text theme={null}
POST /api/v1/connect/attachments
```

İstek `multipart/form-data` olmalıdır.

## Örnek

```bash theme={null}
curl "https://api.plato.ae/api/v1/connect/attachments" \
  -X POST \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  -F "files=@receipt.pdf"
```

İstek başına en fazla 5 dosya yükleyin.

Her dosya en fazla 25 MB olabilir.

## Cevap

```json theme={null}
{
  "files": [
    {
      "id": "file_123",
      "name": "receipt.pdf",
      "s3Key": "workspace/path/receipt.pdf",
      "type": "application/pdf",
      "url": "https://app.plato.ae/api/assets/workspace%2Fpath%2Freceipt.pdf"
    }
  ]
}
```

Döndürülen `id` ve `s3Key` değerlerini saklayarak yüklenen varlığı ilgili Connect360 iş akışıyla ilişkilendirin.

## Özel Bir Ek İndirin

```text theme={null}
GET /api/v1/connect/assets/[...key]
```

Yükleme yanıtının döndürdüğü `s3Key`'yi kullanın.

```bash theme={null}
curl "https://api.plato.ae/api/v1/connect/assets/workspace/path/receipt.pdf" \
  -H "Authorization: Bearer $PLATO_API_KEY" \
  --output receipt.pdf
```

API anahtarı dosyayla aynı çalışma alanına ait olmalıdır.

## İzinler

Yükleme şunları gerektirir:

```text theme={null}
connect360:conversation:engage
```

İndirme aşağıdakilerden birini gerektirir:

```text theme={null}
connect360:conversation:read
```

veya:

```text theme={null}
connect360:conversation:engage
```

## Notlar

* Dosya adları yüklemeden önce normalleştirilir.
* Yüklenen dosyalar Drive içindeki bir Connect360 klasöründe saklanır.
* Döndürülen URL, özel bir varlık rotasına işaret edebilir. Özel dosyaları alırken API anahtarını sunucuda tutun.