Integrasi
Panduan integrasi situs
Cara perubahan sampai ke situs Anda tergantung cara situs itu dibuat. Mulailah dengan situs dan data uji, lalu pastikan ke mana setiap perubahan pergi dan apakah ia dipublikasikan.
Bukan developer? Panduan penyiapan menjelaskan cara menghubungkan Google dan WordPress dengan tangkapan layar.
Persiapan umum
API untuk situs buatan sendiri dan tugas draf CMS memerlukan paket Growth atau Pro yang aktif, verifikasi kepemilikan situs yang sudah terkonfirmasi, dan persetujuan pemilik untuk setiap perubahan. Konfirmasi kepemilikan di layar Connections, lalu buat kunci yang bisa mencatat hasil di layar API. Kunci API saja tidak bisa menyetujui perubahan.
Petakan setiap URL halaman HTTPS dan kolom perubahan, satu per satu, ke rekaman dan kolom CMS yang benar-benar tampil di halaman itu. Sebelum menyiapkannya, siapkan data uji, penanggung jawab, dan prosedur publikasi Anda.
Situs buatan sendiri
Implementasikan pemrosesan di server situs Anda sesuai spesifikasi API perubahan. Ambil perubahan yang disetujui, periksa URL dan kolom terhadap daftar yang diizinkan, dan simpan draf hanya jika nilai saat ini sama dengan nilai “sebelum”. Laporkan versi yang disimpan dan hasilnya ke API.
Kolom yang didukung adalah title, description, h1, dan body. Misalnya, petakan title dari https://example.com/about ke judul rekaman “Tentang kami” milik Anda. Publikasi dilakukan terpisah, setelah dicek oleh seseorang.
WordPress
Hubungkan situs dari layar Connections. Siapkan kata sandi aplikasi untuk pengguna WordPress yang bisa mengedit pos dan halaman sasaran, dan coba dulu di halaman uji. Batasi pada izin edit yang diperlukan, dan cabut kata sandi yang tidak lagi dipakai. Langkah dengan tangkapan layar ada di Hubungkan WordPress.
Menerapkan ke halaman yang sudah terbit langsung memperbarui konten yang tayang. Tindakan seperti Use this edit adalah persetujuan untuk menulis. Membuat draf terpisah tidak didukung. Untuk page builder dan kolom yang tidak bisa diedit, salin teks dan terapkan secara manual.
Tugas draf CMS
Untuk microCMS, Shopify, Webflow, Contentful, dan Sanity tersedia contoh tugas draf yang berjalan di pihak Anda. Tugas ini memerlukan Node.js 22.13 atau lebih baru dan jurnal SQLite pribadi di disk persisten. Berikan rahasia CMS sebagai variabel lingkungan dari penyimpanan rahasia server Anda sendiri, dan jangan pernah menaruhnya di browser, berkas konfigurasi, atau log. Get1pct tidak menyimpan rahasia CMS Anda dan tidak menjalankan tugas ini untuk Anda.
Saat ini ini adalah implementasi uji. Untuk kelimanya, penyimpanan draf, pembacaan ulang, dan hasil eksekusi ulang sudah dikonfirmasi di lingkungan nyata, dengan konten belum terbit di lingkungan uji khusus. Pengecekan hanya mencakup item uji tersebut. Untuk Shopify, nama produk sudah dicek; kolom SEO belum diuji dengan API sungguhan.
Contoh di bawah memetakan URL dan kolom Get1pct ke endpoint, ID konten, dan kolom microCMS. Ganti nilainya sesuai lingkungan uji Anda.
{
"projectId": "test-project-id",
"provider": "microcms",
"options": { "serviceId": "example-sandbox" },
"targets": [{
"page": "https://example.com/about",
"field": "title",
"target": {
"endpoint": "draft-fixtures", "id": "about", "field": "title",
"draftKeyEnv": "MICROCMS_DRAFT_KEY_ABOUT"
}
}]
}Variabel lingkungan umum adalah GET1PCT_API_ORIGIN, GET1PCT_PROJECT_ID, GET1PCT_API_KEY, GET1PCT_CMS_CONFIG, dan GET1PCT_CMS_JOURNAL. Kredensial tiap CMS dimasukkan ke variabel di bawah.
Shopify
Buat aplikasi di Dev Dashboard dan dapatkan token server dengan client credentials grant. Gunakan toko pengembangan yang tidak memublikasikan, dengan produk DRAFT yang belum terbit. Isi SHOPIFY_INTEGRATION_TOKEN dengan token yang punya read_products dan write_products, lalu tentukan shop (misalnya example.myshopify.com) dan productId (misalnya gid://shopify/Product/123). title dan description dipetakan ke kolom SEO dan h1 ke nama produk; teks isi tidak didukung.
Webflow
Isi WEBFLOW_INTEGRATION_TOKEN dengan token yang punya akses baca dan tulis CMS untuk situs uji. Tentukan kolom PlainText yang bisa diedit di bahasa utama dengan collectionId, itemId, dan fieldSlug. Pastikan template benar-benar menampilkan kolom itu. Perubahan disimpan di staging; publikasi adalah langkah terpisah.
Contentful
Di space dan environment uji, isi CONTENTFUL_INTEGRATION_TOKEN dengan token management API yang bisa membaca dan mengedit entri sasaran. Tentukan spaceId, environmentId, entryId, fieldId, dan locale (misalnya en-US). Kolom teks yang sudah ada didukung; Rich Text tidak. Perubahan pada entri yang sudah terbit tetap belum terbit sampai Anda memublikasikannya terpisah.
Sanity
Di dataset uji, isi SANITY_INTEGRATION_TOKEN dengan token yang bisa membaca dan mengedit draf sasaran. Tentukan projectId, dataset, documentId yang sudah ada dan diawali drafts., serta kolom string field. Portable Text tidak didukung. Periksa konten di Studio dan publikasikan terpisah jika ingin ditayangkan.
microCMS
Siapkan list API dan konten belum terbit di layanan uji, lalu isi MICROCMS_INTEGRATION_API_KEY dengan kunci yang dibatasi pada GET dan PATCH untuk API itu. Isi draftKey dari draf ke variabel lingkungan yang disebut oleh draftKeyEnv di konfigurasi. Tentukan serviceId, endpoint, id, dan kolom teks field. Hanya konten belum terbit yang sudah ada yang didukung.
Pengujian dan operasional
- Dengan data uji, pastikan URL, kolom, dan nilai “sebelum” cocok, lalu proses satu perubahan yang disetujui saja.
- Periksa nilai dan versi draf di admin CMS, dan pastikan halaman yang tayang tidak berubah. Uji pembaruan langsung WordPress di halaman uji.
- Selidiki setiap ketidakcocokan nilai “sebelum” atau kesalahan izin. Jika Anda tidak tahu apakah penyimpanan berhasil, lanjutkan dengan jurnal yang sama dan baca ulang. Jangan mengirim ulang begitu saja atau menghapus jurnal.
Dengan microCMS, Shopify, dan Webflow, pengeditan bersamaan antara pengecekan terakhir dan penyimpanan tidak bisa dicegah sepenuhnya. Selama pengujian, pastikan tidak ada orang atau tugas lain yang mengedit rekaman yang sama.