Langsung ke konten
mini.casa
Pengembang

Pindahkan portofolio melalui langkah yang mudah dipahami

Impor, jalankan simulasi, setujui rencana persisnya, lalu jalankan dalam kelompok yang dapat dijeda, dicoba ulang, dan dikembalikan.

Pekerjaan massal dibangun agar tidak ada yang berubah sebelum seseorang melihat dan menyetujui rencana persisnya. Anda memerlukan koneksi dengan portfolios:read, portfolios:write, portfolios:execute, dan approvals:request, beserta cakupan casa untuk tindakan yang direncanakan.

Impor inventaris

POST /workspaces/{id}/portfolios menerima CSV dengan header item_key,domain,source_url,world_handle,template_id,content_language atau kolom yang sama sebagai items[], hingga 1000 baris, dengan preserve_existing_mx: true. Setiap baris diperiksa tersendiri: domain dinormalisasi, duplikat dan URL tidak aman diblokir, serta teks yang ditemukan pada sumber disimpan sebagai data tidak tepercaya. Belum ada tindakan lain yang dilakukan.

Siapkan dan baca rencana simulasi

POST /workspaces/{id}/bulk-plans menerima tindakan yang Anda inginkan (create_draft, apply_import, set_dna, publish, dan langkah domain), batas anggaran, serta rollout_batches seperti [5, 95]: uji coba awal lima item, lalu sisanya. Respons berupa manifes yang tidak dapat diubah dan plan_hash-nya. Baca melalui GET /bulk-plans/{plan_id}: setiap langkah per item, apa yang akan diubah, serta cara mengembalikannya. Langkah DNS hanya menyentuh catatan situs dan mempertahankan catatan email seperti semula. Rencana kedaluwarsa setelah 24 jam.

Minta persetujuan pemilik

POST /workspaces/{id}/approvals mengikat plan_hash persis, batas, dan waktu kedaluwarsa, lalu mengembalikan approval_url. Hanya pemilik yang dapat memutuskannya melalui peramban setelah masuk ulang, dengan mengonfirmasi hash yang ditampilkan. Rencana yang berubah tidak pernah dapat menggunakan ulang persetujuan, dan token tidak pernah dapat menyetujui.

Jalankan, pantau, dan arahkan

  • POST /bulk-plans/{plan_id}/execute dengan plan_hash dan approval_id memulai satu proses yang diizinkan persetujuan tersebut. Kelompok uji coba awal berjalan terlebih dahulu; continue memulai sisanya.
  • Pantau GET /bulk-runs/{run_id} atau webhook job.updated dan job.item.updated.
  • pause, resume, cancel, dan retry (langkah selesai tidak diulang) mengarahkan proses. rollback membatalkan hasil penulisan proses selama hasil tersebut belum berubah.

Pendaftaran, pesan yang sudah dikirim, dan propagasi DNS yang sudah berlalu tidak dapat dibalik serta tidak pernah dilaporkan sebagai sudah dikembalikan. Mencabut token menghentikan pekerjaan baru pada langkah berikutnya.

Apa yang aktif hari ini

Impor, validasi, rencana simulasi, dan persetujuan berfungsi di semua lingkungan. Pelaksanaan berjalan dari awal hingga akhir menggunakan penyedia domain, DNS, dan sertifikat simulasi dalam lingkungan pengembangan serta pengujian. Pelaksanaan tetap dinonaktifkan dalam produksi hingga koneksi penyedia nyata tersedia. GET /capabilities melaporkannya sebagai bulk.execute.