Импорт через API - Video CDN [RU]
Импорт файлов через API — один из наиболее распространённых и гибких способов загрузки контента в CDN. Этот метод позволяет указать системе загрузить конкретный файл из указанного источника, отправив запрос на импорт, по сути говоря CDN «скачайте этот файл отсюда».
CDN поддерживает несколько протоколов для получения файлов, включая http(s)|ftp|rsync(+ssh)|s3:
http[s]://[user:password@]host[:port]/path/to/file.mp4
ftp://[user:password@]host[:port]/path/to/file.mp4
rsync://[user:password@]host[:port]/path/to/file.mp4
rsync+ssh://user:password@host[:port]/path/to/file.mp4
s3://access-key:secret-access-key@endpoint.host/bucket/path/to/file.mp4См. также
Как получить доступ к Video CDN API
Руководство по получению API-учётных данных
Как импортировать файлы через API
Руководство по импорту файлов
Полная справочная информация по всем методам API
Проверка
Во время процесса импорта система проверяет целостность каждого файла. Проверка размера обязательна: фактический размер загруженного файла должен соответствовать значению, указанному в параметре size запроса.
Дополнительно можно указать контрольную сумму sha-256 через параметр chksum для дополнительной проверки.
Переопределение настроек
При запуске импорта через API вы можете задать индивидуальные настройки доставки и защиты для каждого файла. Эти переопределения на уровне файла позволяют точно настроить поведение без изменения глобальных конфигураций.
Следующие параметры могут использоваться для переопределения значений по умолчанию:
protection— определяет контроль доступа или уровень безопасности для конкретного файлаspeed— задаёт ограничения скорости доставки, например, для синхронизации воспроизведения с битрейтом видеоbuffer— настраивает начальную буферизацию для более плавного запуска воспроизведения
Эти переопределения применяются во время импорта и привязаны к конкретному файлу, что обеспечивает детальный контроль над тем, как каждый объект доставляется через CDN.
Приоритизация импорта
При импорте большого пакета файлов могут возникнуть ситуации, когда определённый файл необходимо загрузить и обработать раньше остальных. Для этого в запросе на импорт можно использовать параметр fetch_prio.
Этот параметр повышает приоритет файла в очереди импорта, позволяя системе загрузить и обработать его до элементов с более низким приоритетом. Особенно полезно для контента с ограниченным сроком действия или срочных обновлений, которые должны быть доступны без ожидания завершения всего пакета.
Повторный импорт и дубли
Если добавляемый файл уже существует в системе и отмечен как «failed», он будет автоматически заменён без каких-либо ограничений.
Если существующий файл не помечен как failed, замена разрешена только в том случае, если новый запрос на импорт содержит другое значение size или chksum. Это гарантирует, что добавляемый файл не идентичен уже существующему.
Чтобы явно запретить перезапись существующего файла независимо от его состояния, можно использовать параметр no_replace. При установке в «true» эта опция блокирует замену любого файла, уже присутствующего в CDN.
Скрипты
Не все пользователи умеют писать код или работать с API напрямую. Многие предпочитают решение, которое работает «из коробки», без привлечения разработчиков. Для таких сценариев мы предоставляем готовый вспомогательный скрипт, который позволяет выполнять push-импорт с минимальной настройкой.
С этим методом достаточно скачать скрипт, указать папку с файлами и запустить его. Скрипт автоматически загружает все файлы из указанной папки в CDN для распределения — код писать не нужно, требуется лишь несколько базовых настроек.
Этот метод лучше всего подходит для проектов с осязаемым количеством файлов. Для крайне больших объёмов контента (например, сотни терабайт) импорт всего может быть непрактичным или дорогостоящим.
Если вы столкнётесь с проблемами при установке или настройке, обратитесь в нашу службу технической поддержки.