Частые вопросы по библиотеке материалов

Частые вопросы

Созданная в консоли группа не видна через интерфейс

Группы, созданные в консоли, появляются в GET /api/v1/materials/groups. Если у вас есть только ID группы, его можно напрямую использовать как group_id в POST /api/v1/materials/assets: платформа сначала убедится, что группа существует, затем привяжет её к текущей учётной записи, после чего она появится в списке групп.

Где посмотреть причину сбоя проверки

Причина сбоя возвращается в data.asset.error_message при запросе материала; содержимое есть только при status = Failed, а в нормальном и доступном состоянии значение — null.

Сколько времени занимает проверка изображения

Проверка и предварительная обработка выполняются асинхронно; время зависит от самого материала, и платформа не обещает единого срока для всех изображений. Программа должна опрашивать один и тот же ID материала и не отправлять материал повторно только из-за того, что начальный статус — Processing.

Будут ли ограничения при частых запросах

Запрос статуса — лёгкий интерфейс, но не выполняйте повторные параллельные запросы в течение одного цикла опроса; рекомендуется запрашивать один и тот же ID материала раз в 5–10 секунд. При слишком частых запросах интерфейс возвращает HTTP 429, достаточно повторить позже; на уже отправленные материалы это не влияет.

Какие требования к адресу изображения

Это должен быть http(s)-адрес, который сервер платформы может скачать напрямую (поддерживаются и http, и https); он не должен зависеть от Cookie, Referer, страницы входа или белого списка IP. Если изображение находится за адресом, требующим входа, во внутренней сети или существует только как локальный файл, сначала перенесите его в объектное хранилище или используйте data_url, иначе обработка материала завершится ошибкой.

Если можно предоставить публичный адрес, отдавайте предпочтение image_url: платформа передаёт адрес как есть, без скачивания и пересохранения, поэтому отправка на проверку происходит быстрее всего; data_url требует загрузки base64 всего изображения, заметно медленнее и занимает хранилище платформы.