Руководство по API и MCP для общедоступных ссылок Drive
Создание, просмотр и отзыв общедоступных ссылок TrekMail Drive через REST API или MCP с датами истечения срока, ограничениями скачиваний и журналом аудита.
Сведения о статье
Тип, сложность, тарифы и дата последнего обновления.
▼
Сведения о статье
Тип, сложность, тарифы и дата последнего обновления.
- Тип
- Справочная статья
- Сложность
- Средний уровень
- Тарифы
- Starter · Pro · Agency · + Drive Add-on
- Обновлено
- 10 сен 2026 г.
Общедоступные ссылки позволяют передать файл Drive за пределы учетной записи TrekMail без отправки большого вложения по электронной почте. API и инструменты MCP могут создавать ссылки, показывать список ссылок для файла и отзывать ссылки, когда доступ следует прекратить.
Используйте общедоступные ссылки для передачи материалов клиентам, счетов, видеофайлов, пакетов экспорта и любых файлов, которые слишком велики или нужны на слишком короткое время, чтобы прикреплять их к письму.
Необходимые разрешения
Для файлов в Drive учетной записи используйте drive:account:share. Для файлов в Drive почтового ящика используйте drive:mailbox:share. Разрешение на чтение также будет полезно, поскольку в большинстве процессов перед предоставлением доступа нужно найти файл.
Разрешения для общего доступа не позволяют загружать, переименовывать, перемещать, отправлять в корзину, восстанавливать или окончательно удалять файлы. Не объединяйте их с другими разрешениями, если единственная задача агента состоит в передаче файлов.
Создание ссылки через REST
curl -s -X POST "https://trekmail.net/api/v1/drive/files/{FILE_ID}/share-links" \
-H "Authorization: Bearer tm_live_your_token" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: share-{FILE_ID}-client-a" \
-d '{"expires_at":"2026-06-01T00:00:00Z","max_downloads":25}'
Ответ содержит общедоступный URL. Необработанный токен общей ссылки возвращается только при создании. Если вы его потеряете, отзовите ссылку и создайте новую.
Создание ссылки через MCP
drive_share_create(file_id=123, expires_at="2026-06-01T00:00:00Z", max_downloads=25)
Попросите агента вернуть URL в окончательном ответе и указать срок действия и ограничение на число скачиваний.
Просмотр и отзыв ссылок
Используйте endpoint списка или drive_share_list, чтобы просмотреть активные и предыдущие ссылки для файла. Отзывайте ссылку, если она была отправлена не тому человеку, договор больше не действует или временный период передачи завершился.
drive_share_revoke(link_id=456)
Отзыв вступает в силу немедленно. Если доступ нужно восстановить, создайте новую ссылку.
Рекомендуемые значения по умолчанию
| Сценарий использования | Срок действия | Ограничение скачиваний |
|---|---|---|
| Файл на проверку клиенту | 7-14 дней | 10-50 |
| Подписанный договор | 30-90 дней | 5-20 |
| Материал публичной кампании | Дата завершения кампании | При необходимости более высокий лимит |
| Временная внутренняя передача | 1-7 дней | 5-10 |
Ссылки без ограничений удобны, но позднее их сложнее контролировать. Если вы решили не задавать срок действия, добавьте в своей системе примечание с объяснением причины.
Обеспечение безопасности
Общедоступная ссылка доступна любому, у кого есть URL. Ее защищает токен, который невозможно угадать, а не вход в TrekMail. Не отправляйте общедоступные ссылки на файлы, к которым требуется доступ только указанных получателей, если ваша организация не принимает такую модель.
Страница скачивания не раскрывает лишних данных учетной записи. Истекшие, отозванные или исчерпавшие лимит ссылки перестают работать, не раскрывая конфиденциальные сведения о файле.
Журнал аудита
Создание и отзыв общедоступных ссылок регистрируются с указанием токена API. Если агент создает ссылки для клиентов, периодически проверяйте журнал аудита и заменяйте токены при изменении обязанностей участников команды.
Связанные статьи
Похожие статьи
Перейдите к близким руководствам, которые продолжают рабочий процесс.