Переносите портфель понятными шагами
Импортируйте, выполните пробный прогон, утвердите точный план и запускайте группы с паузой, повтором и откатом.
Массовая работа устроена так, что ничего не меняется, пока человек не увидит и не утвердит точный план. Требуется подключение с portfolios:read, portfolios:write, portfolios:execute и approvals:request, а также области доступа casa для планируемых действий.
Импортируйте перечень
POST /workspaces/{id}/portfolios принимает CSV с заголовком item_key,domain,source_url,world_handle,template_id,content_language или те же поля как items[], до 1000 строк, с preserve_existing_mx: true. Каждая строка проверяется отдельно: домены нормализуются, дубликаты и небезопасные URL блокируются, а найденный в источнике текст сохраняется как недоверенные данные. Больше пока ничего не происходит.
Подготовьте и прочитайте пробный план
POST /workspaces/{id}/bulk-plans принимает нужные действия (create_draft, apply_import, set_dna, publish и доменные шаги), пределы бюджета и rollout_batches, например [5, 95]: пробная группа из пяти, затем остальные. Ответ содержит неизменяемый манифест и его plan_hash. Прочитайте его через GET /bulk-plans/{plan_id}: каждый шаг по каждому элементу, предполагаемые изменения и способ отката. Шаги DNS затрагивают только записи сайта и сохраняют почтовые записи. Планы истекают через 24 часа.
Попросите владельца одобрить
POST /workspaces/{id}/approvals привязывает точный plan_hash, пределы и срок действия и возвращает approval_url. Решение может принять только владелец в браузере после повторного входа, подтвердив показанный хеш. Изменённый план никогда не использует прежнее одобрение, а токен никогда не может одобрить.
Запускайте, наблюдайте и управляйте
POST /bulk-plans/{plan_id}/executeсplan_hashиapproval_idначинает единственный запуск, разрешённый одобрением. Сначала выполняется пробная группа;continueзапускает остальные.- Следите через
GET /bulk-runs/{run_id}или вебхукиjob.updatedиjob.item.updated. pause,resume,cancelиretry(завершённые шаги не повторяются) управляют запуском.rollbackотменяет записанное запуском, пока оно не изменилось.
Регистрации, отправленные сообщения и уже прошедшее распространение DNS необратимы и никогда не отмечаются как отменённые. Отзыв токена останавливает новую работу на следующем шаге.
Что работает сегодня
Импорт, проверка, пробные планы и одобрения работают везде. В средах разработки и тестирования выполнение проходит весь путь с имитируемыми провайдерами доменов, DNS и сертификатов, а в рабочей среде остаётся выключенным до подключения настоящих провайдеров. GET /capabilities сообщает об этом как bulk.execute.