Массовый импорт и экспорт коротких ссылок

Когда нужно сократить десятки или тысячи URL, загрузите их одним файлом CSV, а не создавайте каждую ссылку вручную. Каждая строка становится обычной короткой ссылкой, которую можно редактировать, публиковать и отслеживать как любую другую.

Импорт коротких ссылок из файла CSV

Откройте Сокращатель ссылок в панели управления и выберите массовый импорт.
Скачайте шаблон CSV, заполните по одной строке на ссылку и сохраните его как CSV.
Загрузите файл и выберите значения по умолчанию для строк с пустым столбцом, например шаблон или тег.
Проверьте файл. Posty5 читает каждую строку, ничего не создавая, и показывает строки, которые завершатся ошибкой.
Запустите импорт. Можно покинуть страницу, а по завершении придёт уведомление.

Столбцы файла

Обязателен только столбец url. Регистр в названиях столбцов не важен, а неизвестный Posty5 столбец игнорируется и указывается на шаге проверки.

Column
`url`	Адрес назначения. Обязателен. Также принимается под именем baseUrl.
`name`	Название для вашего списка. Если оставить пустым, Posty5 заполнит его заголовком страницы в фоновом режиме.
`customId`	Собственное окончание короткой ссылки, если ваш тариф разрешает свои ID. Оно должно быть свободно, в том числе от более ранних строк того же файла.
`tag`	Тег для последующей группировки и фильтрации ссылок.
`refId`	Ваш собственный идентификатор, например код товара из вашей системы.
`templateId`	Шаблон QR-кода для этой строки. Он заменяет выбранный по умолчанию.

url,name,customId,tag,refId,templateId
https://example.com/spring-sale,Spring sale,,spring,,

Сохраните файл как CSV в UTF-8 с запятыми и строкой заголовков. Значения с запятыми заключаются в двойные кавычки, табличные редакторы делают это сами.

Проверка файла

Проверка применяет те же правила, что и ручное создание ссылки, и показывает каждую ошибочную строку с её номером, считая от первой строки под заголовком. Строка не проходит, если

URL отсутствует, не является корректным веб-адресом или длиннее 2,048 символов
URL заблокирован как небезопасный
название, тег или идентификатор длиннее 255 символов
свой ID недоступен на вашем тарифе, некорректен или уже занят
шаблон не существует или принадлежит не вам

Ограничения

Один файл содержит до 5,000 строк и до 2 MB.
В сутки (UTC) можно создать массово до 20,000 строк с учётом всех импортов и вызовов API вместе.
Одновременно выполняется один импорт, и ещё до трёх могут ждать в очереди.
Если кредиты закончатся во время импорта, эта строка и все следующие завершатся ошибкой «Недостаточно кредитов», а уже созданные ссылки останутся.

Ход выполнения

Страница импорта показывает, сколько строк обработано, создано и завершилось ошибкой, и обновляется сама. Запущенный импорт можно отменить, ссылки, созданные до отмены, останутся.

Заголовки страниц и глубокие ссылки в приложения загружаются в фоне после создания каждой ссылки, поэтому некоторое время ссылка может показывать в качестве названия свой хост.

Файл результатов

После завершения импорта скачайте файл результатов. В нём по одной строке на каждую строку вашего файла.

Column
`row`	Номер строки в вашем файле, считая от первой строки под заголовком.
`status`	created, failed, skipped или notProcessed, если импорт остановился раньше этой строки.
`id`, `shortUrl`	ID и короткий адрес новой ссылки.
`errors`	Причина ошибки в строке.

Второй файл содержит только ошибочные строки с вашими исходными значениями, чтобы их можно было исправить и загрузить этот файл снова.

Прошлые импорты

В разделе массовых заданий перечислены недавние импорты с их статусом и счётчиками. Откройте любой, чтобы увидеть ход выполнения или снова скачать его файлы.

Массовое создание через API

Разработчики могут отправить до 100 строк одним запросом и сразу получить результат по каждой строке или отправить файл до 5,000 строк как задание и опрашивать его. Действуют те же ограничения и проверки, а запрос учитывает заголовок Idempotency-Key, чтобы повторный запрос не создал ссылки дважды. Маршруты описаны в справочнике API (Swagger).

POST /api/short-link/bulk
POST /api/link-bulk-jobs
GET /api/short-link/export

Экспорт ссылок

В списке коротких ссылок выберите экспорт CSV или экспорт JSON, чтобы скачать ссылки со счётчиками посещений.

Экспорт учитывает фильтры, применённые к списку, поэтому сначала отфильтруйте его, чтобы экспортировать только часть.
Один экспорт содержит до 50,000 строк, новые сначала. Более длинный список обрезается, и файл сообщает об этом в последней строке (CSV) или в поле truncated (JSON).
Ячейка, начинающаяся с = + - или @, получает в CSV начальный апостроф, чтобы табличный редактор показал её как текст, а не выполнил как формулу.