Вложения
Скачивание файлов по ключу и подписанные временные ссылки для чужих систем.
На этой странице
Вложение в сообщении #
| Поле | Тип | Обяз. | Описание |
|---|---|---|---|
| id | uuid | да | номер файла |
| type | string | да | image, document, audio, video |
| name | string | нет | имя файла |
| size | int | нет | размер в байтах |
| mimeType | string | нет | тип содержимого |
| url | string | нет | подписанная ссылка со сроком |
| urlExpiresAt | RFC 3339 | нет | когда ссылка перестанет работать |
Подписанная ссылка #
GET /media/signed/{id}?exp=…&sig=…
Ссылка не требует ключа: её открывает чужой сервер, у которого нашего входа нет. Защита — подпись и срок в час. Раздавать переписку по угадываемому адресу нельзя, поэтому открытых ссылок на вложения не существует.
Скачать по ключу #
GET /api/v1/media/{id} media:read
Отдаёт сам файл с его типом содержимого. Годится, когда подписанная ссылка просрочилась или когда файл забирает ваш серверный код.
curl -s -o act.pdf https://api.widgetchat.ru/api/v1/media/9f2c… -H "Authorization: Bearer wck_…"