cd90b0d58a
- Создан API create_document_with_text.php для создания DOCX/XLSX/PPTX с текстом от AI - Поддержка Markdown форматирования (заголовки, жирный, курсив, списки, код) - Установлен PHPWord для красивого форматирования документов - Исправлены пути сохранения (crm2/CRM_Active_Files/... без /crm/ в начале) - Замена пробелов на подчеркивания в именах папок - Создана документация для AI и разработчиков - Добавлены API для работы с шаблонами Nextcloud
91 lines
2.0 KiB
Markdown
91 lines
2.0 KiB
Markdown
# 📎 API для привязки документов
|
||
|
||
## ✅ Прямой эндпоинт (готов к использованию!)
|
||
|
||
```
|
||
POST https://crm.clientright.ru/api_attach_documents.php
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 Формат запроса (из n8n)
|
||
|
||
```json
|
||
[
|
||
{
|
||
"contact_id": "320096",
|
||
"project_id": "396868",
|
||
"ticket_id": "396936",
|
||
"filename": "boarding_pass.pdf",
|
||
"file_type": "flight_delay_boarding_or_ticket",
|
||
"file": "/f9825c87-4e3558f6-f9b6-405c-ad3d-d1535c49b61c/crm2/CRM_Active_Files/Documents/HelpDesk/ЗАЯВКА_827_396936/flight_delay_boarding_or_ticket.pdf"
|
||
}
|
||
]
|
||
```
|
||
|
||
**Важно:**
|
||
- ✅ Массив `[...]` (даже для одного документа)
|
||
- ✅ `file` без хоста → автоматически добавится `https://s3.twcstorage.ru`
|
||
- ✅ `ticket_id` опционально (если есть → HelpDesk, иначе → Project)
|
||
|
||
---
|
||
|
||
## 📊 Формат ответа
|
||
|
||
```json
|
||
{
|
||
"success": true,
|
||
"total_processed": 1,
|
||
"successful": 1,
|
||
"failed": 0,
|
||
"results": [
|
||
{
|
||
"document_id": "15x396941",
|
||
"document_numeric_id": "396941",
|
||
"attached_to": "ticket",
|
||
"attached_to_id": "396936",
|
||
"file_name": "boarding_pass.pdf",
|
||
"file_type": "flight_delay_boarding_or_ticket",
|
||
"s3_bucket": "f9825c87-...",
|
||
"s3_key": "crm2/CRM_Active_Files/...",
|
||
"file_size": 85320,
|
||
"message": "Документ создан и привязан..."
|
||
}
|
||
],
|
||
"errors": null
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 Тест
|
||
|
||
```bash
|
||
curl -X POST "https://crm.clientright.ru/api_attach_documents.php" \
|
||
-H "Content-Type: application/json" \
|
||
-d '[
|
||
{
|
||
"contact_id": "320096",
|
||
"project_id": "396868",
|
||
"ticket_id": "396936",
|
||
"filename": "test.pdf",
|
||
"file_type": "flight_delay_boarding_or_ticket",
|
||
"file": "/bucket/path/to/file.pdf"
|
||
}
|
||
]'
|
||
```
|
||
|
||
---
|
||
|
||
## 🔍 Логи
|
||
|
||
```bash
|
||
tail -f /var/www/fastuser/data/www/crm.clientright.ru/logs/api_attach_documents.log
|
||
```
|
||
|
||
---
|
||
|
||
## 🎯 Готово к использованию в n8n!
|
||
|
||
|