Eduwebmu

Kenapa otomasi tiba-tiba rusak: versi API yang berubah

Oleh Terbit 17 menit baca

Sampul putih dengan logo Eduwebmu di kanan atas dan judul besar berbunyi Versi API: Kenapa otomasi rusak?
Daftar isi

Otomasi yang jalan mulus berbulan-bulan bisa rusak tanpa kamu mengubah apa pun, karena penyedia API mengganti atau mempensiunkan versi yang dipakai workflow kamu. Kadang kegagalannya keras, berupa error 410 Gone. Kadang diam-diam, berupa data yang bentuknya berubah. Solusinya sederhana: sebut versi secara eksplisit, pantau tanda pensiun, dan catat tanggalnya.

Tesis artikel ini: workflow kamu bergantung pada janji orang lain, dan janji itu punya tanggal kedaluwarsa. Setiap integrasi ke layanan luar memakai satu versi API tertentu, sadar atau tidak. Penyedia layanan menerbitkan jadwal kapan versi itu berhenti didukung. Orang yang membaca jadwal itu jarang kaget. Orang yang tidak membacanya baru tahu ketika pelanggan mengeluh.

Yang perlu diluruskan dulu

Reaksi pertama saat workflow gagal biasanya menyalahkan alat otomasinya. "n8n error lagi", "Make lagi bermasalah", atau "server saya mati". Padahal banyak kegagalan datang dari sisi penyedia API. API (application programming interface) adalah pintu resmi yang dibuka sebuah layanan supaya aplikasi lain bisa mengambil atau mengirim data ke sana. Pintu itu dirawat, diperbaiki, dan sesekali dibongkar oleh pemiliknya.

Hal kedua yang perlu diluruskan: perubahan API umumnya tidak terjadi mendadak. Vendor besar menerbitkan kebijakan versi tertulis, lengkap dengan masa dukungan dan tanggal pensiun. Yang terasa mendadak adalah saat kita tidak pernah membaca pengumuman itu.

Bab Pertanyaan yang dijawab
Versi API dan tempat ia bersembunyi Di mana versi tercatat dalam sebuah permintaan API?
Gagal keras dan gagal diam Apa yang terjadi ketika versi lama pensiun?
Membaca kebijakan vendor Berapa lama versi lama didukung oleh GitHub, Shopify, Meta, dan Stripe?
Versi node di n8n Kenapa workflow lama dan baru bisa berperilaku beda?
Kebiasaan pencegah Apa yang bisa dipasang di workflow supaya tidak kaget?
Ringkasan Apa yang dicek minggu ini?

Catatan jujur. Artikel ini ditulis 2 November 2026. Angka masa dukungan dan nama versi diambil dari dokumentasi resmi tiap vendor pada tanggal itu, dan semuanya bisa berubah. Artikel ini juga tidak membahas cara menulis kode untuk migrasi. Fokusnya memahami konsep dan membangun kebiasaan.

Artikel ini untuk kamu yang punya workflow di n8n, Make, Zapier, atau skrip sederhana yang memanggil layanan luar, dan ingin tahu kenapa sesuatu yang dulu jalan sekarang tidak. Artikel ini kurang cocok kalau kamu justru sedang merancang API sendiri untuk dipakai orang lain. Topik itu menyangkut desain dan tata kelola yang lebih luas.

Versi API dan tempat ia bersembunyi

Versi API adalah label yang menandai satu set aturan tetap: alamat mana yang tersedia, data apa yang diterima, dan bentuk jawaban yang dikirim balik. Menurut blog n8n tentang strategi versi API (22 Oktober 2026), versi dipisahkan supaya penyedia bisa mengubah layanannya tanpa memaksa semua integrasi lama ikut berubah saat itu juga.

Perubahan yang perlu kamu waspadai disebut breaking change, yaitu perubahan yang bisa membuat integrasi lama gagal atau salah membaca data. Dokumentasi GitHub memberi daftar yang jelas. Yang termasuk breaking change antara lain menghapus operasi, mengganti nama parameter atau kolom jawaban, mewajibkan parameter yang tadinya opsional, mengubah tipe data, menghapus nilai pilihan, dan mengubah syarat autentikasi.

Sebaliknya, perubahan tambahan dianggap aman. Contohnya menambah kolom baru di jawaban atau menambah parameter opsional. GitHub menyebut perubahan tambahan semacam ini tersedia di semua versi yang masih didukung.

Empat tempat versi biasa ditulis

Blog n8n yang sama merangkum empat cara umum penyedia menandai versi. Kamu tidak bisa memilih caranya, karena itu keputusan penyedia. Yang bisa kamu lakukan adalah tahu di mana harus melihat.

  1. Di alamat URL. Contohnya /v1/products. Versinya kelihatan jelas di log dan di pengaturan node, jadi paling mudah diperiksa saat ada masalah.
  2. Di header HTTP. Header adalah informasi tambahan yang ikut dikirim bersama permintaan, seperti kunci akses. Alamatnya tetap sama, versinya diselipkan di header. Kelemahannya, versi tidak terlihat kalau kamu hanya melihat URL.
  3. Berupa tanggal. Versinya bernama tanggal rilis, misalnya 2026-10. Tanggal tidak menjelaskan isi perubahan, jadi kamu tetap perlu membaca catatan rilis.
  4. Di parameter query. Versi ditempel di ujung URL, misalnya ?version=v1. Mudah dibaca, tetapi sistem cache bisa keliru bila mengabaikan parameter itu.

Di dunia nyata, cara-cara ini sering digabung. GitHub memakai versi bertanggal yang dikirim lewat header X-GitHub-Api-Version. Shopify memakai nama versi bertanggal per kuartal, misalnya 2026-10, yang ditulis di URL permintaan. Meta menaruh versi seperti v4.0 di URL Graph API. Stripe memakai header Stripe-Version dengan nama versi berisi tanggal dan nama rilis, misalnya 2026-10-28.endive.

Versi yang tidak kamu tulis tetap ada

Bagian ini yang paling sering menjebak. Kalau kamu tidak menyebut versi, API tidak berhenti bekerja. Ia memakai versi default. Masalahnya, versi default itu ditentukan pihak lain dan bisa bergeser.

Contohnya di referensi API Stripe. Permintaan tanpa header Stripe-Version memakai versi default akun Stripe kamu, yang diatur di Workbench. Webhook juga memakai versi default akun, kecuali versinya ditetapkan saat endpoint dibuat. Artinya, seseorang di tim yang menaikkan versi default akun bisa mengubah bentuk data yang diterima semua workflow sekaligus.

GitHub lain lagi. Permintaan tanpa header versi saat ini diperlakukan sebagai versi 2022-11-28, padahal versi terbarunya 2026-03-10, dan menurut tabel GitHub versi 2022-11-28 didukung sampai 10 Maret 2028. Ketika sebuah versi ditutup, permintaan tanpa versi diarahkan ke versi tertua berikutnya yang masih didukung. GitHub sendiri memperingatkan bahwa integrasi yang mengandalkan permintaan tanpa versi bisa melihat perubahan perilaku seiring versi lama dipensiunkan.

Gagal keras dan gagal diam: dua nasib versi lama

Ketika sebuah versi sampai di akhir masa dukungan, ada dua kemungkinan yang terjadi pada workflow kamu. Perbedaannya menentukan seberapa cepat kamu sadar ada masalah.

Diagram dua nasib versi API lama: dari aktif ke deprecated dengan header Deprecation dan Sunset, lalu setelah tanggal sunset bercabang menjadi gagal keras dengan 410 Gone seperti GitHub, atau gagal diam karena dialihkan ke versi tertua yang masih bisa dipakai seperti Shopify dan Meta
Apa yang terjadi pada permintaan ke versi API yang sudah pensiun, menurut dokumentasi resmi tiap vendor

Gagal keras: 410 Gone

GitHub memilih jalan yang tegas. Menurut dokumentasinya, permintaan yang menyebut versi API yang sudah tidak didukung akan menerima respons 410 Gone. Kode ini berarti sumber daya sudah tidak tersedia dan kemungkinan permanen.

Blog n8n menyarankan hal yang masuk akal untuk kondisi ini: jangan mengulang permintaan yang sama. Mengulang tidak akan menolong, karena versinya memang sudah hilang. Workflow sebaiknya mengenali respons itu dan mengalihkannya ke jalur penanganan khusus.

Gagal keras terdengar menyebalkan, tetapi bagi saya ini nasib yang lebih baik. Eksekusi berhenti, muncul di daftar eksekusi gagal, dan bisa memicu notifikasi. Kamu tahu ada masalah di hari yang sama.

Gagal diam: dialihkan ke versi lain

Shopify dan Meta memilih jalan sebaliknya. Shopify menyebut perilaku ini fall forward. Kalau aplikasi kamu meminta versi yang sudah tidak bisa diakses, Shopify menjawab memakai versi stabil tertua yang masih bisa diakses. Contoh di dokumentasinya: permintaan ke versi 2024-10 yang sudah pensiun dilayani oleh versi stabil tertua yang tersisa. Satu-satunya petunjuk ada di header X-Shopify-API-Version pada respons. Kalau isinya beda dari versi yang kamu minta, berarti permintaanmu sudah dialihkan.

Dokumentasi versi Graph API Meta menyebut hal serupa. Setelah sebuah versi tidak lagi bisa dipakai, panggilan ke versi itu dialihkan ke versi tertua berikutnya yang masih berlaku. Panggilan yang tidak menyebut versi sama sekali memakai versi yang diatur di dashboard aplikasi, dan Meta menyarankan selalu menyebut versi bila memungkinkan.

Di atas kertas, ini terdengar ramah. Permintaan tetap mendapat jawaban. Masalahnya, jawaban itu mengikuti aturan versi yang lebih baru. Kalau di antara dua versi itu ada kolom yang diganti nama atau dihapus, workflow kamu tidak error. Ia hanya membaca kolom kosong lalu meneruskannya ke langkah berikutnya.

Bayangkan workflow yang menyalin pesanan baru dari toko online ke Google Sheets. Setelah pengalihan versi, satu kolom yang dulu berisi nama kurir kini kosong karena struktur datanya berubah. Tidak ada eksekusi gagal. Tidak ada notifikasi. Tim gudang baru sadar ketika ada paket yang tidak terkirim. Inilah yang dimaksud blog n8n ketika menyebut langkah-langkah berikutnya bisa menerima data yang salah sebelum ada yang menyadarinya.

Dua lapisan versi yang sering terlupa

Ada dua tempat lain di mana versi bisa diam-diam berbeda dari dugaan kamu.

Pertama, pustaka atau SDK. SDK adalah paket kode resmi dari vendor yang membungkus pemanggilan API. Menurut panduan upgrade Stripe, SDK sisi server versi terbaru memakai versi API yang berlaku saat SDK itu dirilis. Jadi memperbarui SDK bisa ikut menaikkan versi API, walaupun kamu tidak menyentuh pengaturan apa pun.

Kedua, webhook. Webhook adalah pesan yang dikirim layanan ke alamatmu saat terjadi sesuatu, misalnya pembayaran berhasil. Stripe menjelaskan bahwa untuk event jenis snapshot, versi data diatur per tujuan pengiriman (event destination) dan hanya bisa ditetapkan saat tujuan itu dibuat. Untuk pindah versi, Stripe menyarankan membuat tujuan baru, mengujinya, baru menghapus yang lama. Shopify juga menyertakan header X-Shopify-Api-Version di setiap webhook untuk menunjukkan versi yang dipakai.

Membaca kebijakan deprecation vendor

Deprecation adalah pengumuman bahwa sesuatu masih berfungsi tetapi akan dipensiunkan. Setiap vendor menulis kebijakannya sendiri, dan detailnya berbeda cukup jauh. Tabel ini merangkum empat vendor yang sering muncul di workflow otomasi.

Vendor Format versi Masa dukungan versi lama Setelah pensiun
GitHub REST API Tanggal, lewat header 24 bulan setelah versi yang lebih baru rilis Respons 410 Gone
Shopify Tanggal per kuartal, di URL Minimal 12 bulan, dengan tumpang tindih minimal sembilan bulan antarversi Dialihkan ke versi stabil tertua yang masih bisa diakses
Meta Graph API Nomor versi, di URL Berhenti dua tahun setelah versi berikutnya rilis (tiap versi dijamin minimal dua tahun) Dialihkan ke versi tertua berikutnya yang masih berlaku
Stripe Tanggal dan nama rilis, lewat header Tidak disebutkan di halaman Versioning dan API upgrades Belum terverifikasi, tidak dijelaskan di dua halaman itu

Beberapa detail dari tiap vendor layak dicatat.

GitHub. Selama versi masih dalam masa dukungan tetapi mendekati penutupan, GitHub menyertakan dua header di respons API. Header Deprecation berisi tanggal versi mulai ditutup. Header Sunset berisi tanggal versi benar-benar dihapus, setelah itu permintaan mendapat 410 Gone.

Shopify. Versi baru rilis setiap tiga bulan, pada hari pertama tiap kuartal pukul 17.00 UTC. Pada 2 November 2026, versi stabil terbaru adalah 2026-10, yang menurut tabel di dokumentasi Shopify didukung sampai 16 Oktober 2027. Shopify menyarankan memperbarui ke versi stabil terbaru setiap kuartal. Ada juga konsekuensi bisnis: aplikasi yang tetap memakai sumber daya tak didukung setelah tenggat bisa dikeluarkan dari Shopify App Store.

Meta. Dokumentasinya memberi contoh hitungan. Kalau v2.3 rilis 25 Maret 2015 dan v2.4 rilis 7 Agustus 2015, maka v2.3 berakhir 7 Agustus 2017, dua tahun setelah v2.4 rilis. Meta juga menyatakan berhak mengubah API dalam waktu singkat untuk urusan keamanan atau privasi.

Stripe. Sejak rilis 2024-09-30.acacia, Stripe merilis versi baru setiap bulan tanpa breaking change. Dua kali setahun, Stripe menerbitkan rilis besar yang dimulai dengan versi berisi breaking change. Menurut Stripe, naik ke rilis bulanan aman tanpa mengubah kode, sedangkan naik ke rilis besar bisa menuntut perubahan.

Standar untuk tanda pensiun

Dua header yang dipakai GitHub punya dasar standar di IETF, lembaga yang menyusun standar teknis internet. RFC 9745 terbit Maret 2025 sebagai dokumen Standards Track dan mendefinisikan header Deprecation. Isinya sinyal bahwa sebuah sumber daya akan atau sudah dinyatakan usang. RFC 8594 dari Mei 2019 mendefinisikan header Sunset, yaitu tanggal ketika sebuah alamat kemungkinan berhenti merespons. Statusnya informasional, bukan standar wajib.

Kabar baiknya, ada bahasa bersama untuk tanda pensiun. Kabar buruknya, tidak semua vendor memakainya. Jadi header ini berguna sebagai tambahan, tidak bisa jadi satu-satunya alarm.

Model AI juga punya tanggal pensiun

Kalau workflow kamu memanggil model AI, logika yang sama berlaku. Halaman deprecation model Anthropic memakai empat istilah. Active berarti didukung penuh. Legacy berarti tidak lagi diperbarui. Deprecated berarti masih jalan tetapi sudah punya tanggal pensiun dan pengganti yang disarankan. Retired berarti permintaan ke model itu gagal.

Anthropic menyatakan memberi pemberitahuan minimal 60 hari sebelum model publik dipensiunkan, kepada pelanggan yang masih aktif memakainya. Enam puluh hari terdengar lama, tetapi cepat habis kalau email pemberitahuan masuk ke kotak yang jarang dibuka. Workflow AI yang menulis nama model langsung di pengaturan node termasuk yang paling rentan.

Lapisan yang kamu kendalikan: versi node di n8n

Sejauh ini kita membahas versi milik penyedia API. Di n8n ada satu lapisan versi lagi, yaitu versi node. Node adalah satu kotak langkah di dalam workflow, misalnya node Gmail atau node Google Sheets.

Dokumentasi n8n tentang versi node menjelaskan aturannya dengan jelas. Kalau sebuah workflow dibangun dan disimpan dengan node versi 1, n8n tetap memakai versi 1 di workflow itu, walaupun versi 2 sudah terbit. Ketika kamu membuat workflow baru dan mencari node, n8n selalu memuat versi terbaru.

Aturan ini melindungi workflow lama dari perubahan mendadak di sisi n8n. Efek sampingnya, dua workflow dengan node bernama sama bisa berperilaku berbeda karena versinya beda. Template lama yang kamu salin dari forum juga membawa versi node lamanya.

Node bawaan menanggung sebagian beban

Blog n8n menyebut bahwa node bawaan untuk sebuah layanan menangani versi API untuk kamu. Saat penyedia API berubah, pengelola node yang menyesuaikan, dan perubahan itu sampai ke kamu lewat pembaruan n8n. Ini alasan utama saya lebih memilih node bawaan bila tersedia. Kamu tidak perlu memantau sendiri jadwal versi setiap vendor.

Batasnya: node lama yang tidak pernah kamu perbarui juga tidak ikut maju. Contohnya ada di artikel tentang n8n 3.0. Menurut daftar breaking changes n8n 3.0, node lama seperti Function dan Cron dihapus. Gmail Trigger versi 1 sampai 1.3 tetap dimuat, tetapi berjalan dengan perilaku versi 1.4. Polanya mirip fall forward di Shopify, hanya terjadi di level node. Versi node yang tertinggal pada akhirnya tetap harus diurus.

HTTP Request: kamu yang memegang versi

Kalau tidak ada node bawaan untuk sebuah layanan, kamu biasanya memakai node HTTP Request. Di sini tanggung jawabnya pindah ke kamu. Blog n8n menyarankan menjadikan versi API bagian dari pengaturan workflow, entah di URL, header, atau parameter. Dengan begitu workflow terus meminta versi yang sudah kamu uji, dan tidak tiba-tiba mewarisi perilaku baru ketika vendor mengganti versi default.

Dokumentasi node HTTP Request punya dua opsi yang relevan. Include Response Headers and Status membuat node mengembalikan header dan kode status, tidak hanya isi jawaban. Opsi ini yang memungkinkan kamu membaca header Deprecation atau Sunset. Never Error membuat node menganggap semua jawaban sukses, apa pun kodenya.

Saya tidak menyarankan menyalakan Never Error tanpa pemeriksaan lanjutan. Opsi itu mengubah gagal keras menjadi gagal diam. Respons 410 Gone akan lolos sebagai "sukses" dan diteruskan ke langkah berikutnya seolah tidak ada apa-apa. Kalau kamu memang perlu menyalakannya, pasang node IF sesudahnya untuk memeriksa kode status.

Kebiasaan yang mencegah kejutan

Kamu tidak bisa mencegah vendor mempensiunkan versi. Yang bisa kamu atur adalah seberapa cepat kamu tahu dan seberapa siap kamu saat tanggalnya tiba. Berikut kebiasaan yang saya sarankan, disusun dari yang paling murah.

1. Buat daftar integrasi beserta versinya

Satu tabel sederhana sudah cukup. Isinya nama workflow, layanan yang dipanggil, versi API yang dipakai, dan apakah versinya ditulis eksplisit atau mengikuti default. Tambahkan kolom tautan ke halaman kebijakan versi vendor. Daftar ini terdengar membosankan, tetapi tanpa daftar ini kamu tidak tahu harus mulai memeriksa dari mana saat pengumuman datang.

Untuk Stripe, panduan upgrade-nya menyebut tab Overview di Workbench menampilkan versi API yang dipakai integrasi kamu. Untuk model AI di Claude, Anthropic menyarankan mengekspor data pemakaian dari halaman Usage di Claude Console untuk melihat model mana yang masih dipakai per kunci API.

2. Tulis versi secara eksplisit

GitHub, Stripe, Meta, dan Shopify sama-sama menyarankan menyebut versi di setiap permintaan. Ini kebiasaan paling murah dengan dampak paling besar. Versi yang ditulis eksplisit tidak ikut bergeser saat default akun diubah orang lain atau saat vendor menutup versi lama.

Konsekuensinya, kamu harus sengaja menaikkan versi dari waktu ke waktu. Menurut saya itu justru bagus. Perubahan versi menjadi keputusan yang kamu ambil dengan sadar, dengan waktu untuk menguji.

3. Pasang error workflow

n8n punya fitur error workflow. Di Workflow Settings, kamu bisa menunjuk satu workflow yang berjalan setiap kali eksekusi gagal. Workflow penanganan ini harus diawali node Error Trigger, dan satu error workflow bisa dipakai bersama oleh banyak workflow.

Error workflow mengubah kegagalan keras menjadi notifikasi, misalnya email atau pesan ke grup tim. Untuk respons 410 Gone, ini cara tercepat tahu bahwa versi API sudah ditutup. Blog n8n juga menyebut fitur debug eksekusi, yaitu memuat data dari eksekusi produksi yang gagal ke workflow saat ini untuk diperiksa dan diuji ulang.

4. Periksa isi data untuk integrasi penting

Error workflow tidak menangkap gagal diam. Untuk workflow yang menyentuh uang, stok, atau pelanggan, tambahkan pemeriksaan sederhana pada data yang masuk. Misalnya, kolom wajib tidak boleh kosong, jumlah item tidak boleh nol, dan tipe datanya sesuai dugaan. Kalau pemeriksaan gagal, hentikan alur dan kirim peringatan.

5. Catat tanggal sunset di kalender tim

Setiap kali kamu membaca header Sunset, menerima email deprecation, atau melihat tanggal pensiun di halaman vendor, masukkan ke kalender bersama. Beri pengingat dua sampai tiga bulan sebelumnya. Blog n8n bahkan menyebut kemungkinan memakai node IF untuk mengalihkan permintaan berdasarkan tanggal server bila vendor sudah mengumumkan tanggal pasti.

6. Uji versi baru di jalur terpisah

Stripe memberi contoh pola yang bisa ditiru di banyak layanan. Untuk webhook, buat tujuan baru dengan versi baru, uji, lalu pindahkan lalu lintas dan matikan yang lama. Selama keduanya aktif, workflow harus aman menerima event yang sama dua kali. Prinsipnya berlaku umum: jangan menaikkan versi di workflow produksi tanpa menjalankannya dulu di salinan.

Yang tidak saya sarankan

Saya tidak menyarankan selalu mengejar versi terbaru di hari rilis. Versi baru kadang membawa breaking change, dan workflow kamu butuh waktu uji. Saya juga tidak menyarankan membiarkan integrasi tanpa versi eksplisit dengan alasan "biar ikut terbaru otomatis". Itu sama saja menyerahkan jadwal perubahan workflow kamu kepada keputusan orang lain.

Ringkasan dan langkah berikutnya

Versi API adalah kontrak yang punya tanggal kedaluwarsa. Vendor besar mengumumkan tanggalnya jauh hari, tetapi cara mereka mengakhiri versi lama berbeda. Ada yang tegas dengan 410 Gone, ada yang mengalihkan diam-diam ke versi lain. Kebiasaan sederhana seperti mencatat versi, menulisnya eksplisit, dan memasang error workflow sudah menutup sebagian besar risiko.

Checklist minggu ini

  • Daftar semua workflow yang memanggil layanan luar sudah dibuat
  • Setiap integrasi sudah dicatat versi API-nya, atau ditandai "mengikuti default"
  • Halaman kebijakan versi tiap vendor sudah ditautkan di daftar itu
  • Node HTTP Request penting sudah menyebut versi secara eksplisit
  • Error workflow dengan Error Trigger sudah dipasang di workflow produksi
  • Workflow yang menyentuh uang atau pelanggan punya pemeriksaan isi data
  • Tanggal sunset yang sudah diketahui masuk ke kalender tim
  • Nama model AI yang dipakai sudah dicek statusnya di halaman deprecation vendor

Cheat sheet

Kalau kamu melihat... Artinya Yang sebaiknya dilakukan
Respons 410 Gone Versi atau sumber daya sudah pensiun permanen Jangan diulang, alihkan ke penanganan error, migrasi versi
Header Deprecation Versi sudah atau akan dinyatakan usang Tandai integrasi untuk migrasi
Header Sunset Ada tanggal pasti versi berhenti Catat tanggalnya di kalender tim
Eksekusi sukses tetapi kolom kosong Kemungkinan dialihkan ke versi lain Cek versi yang dipakai dan catatan perubahan vendor
Email deprecation model AI Model punya tanggal pensiun Uji model pengganti sebelum tanggalnya
Template lama dari forum Membawa versi node lama Ganti dengan node versi terbaru

Langkah paling praktis setelah ini adalah memahami dulu apa yang sebenarnya dilakukan setiap workflow lama kamu, termasuk layanan apa yang dipanggil dan lewat node apa. n8n Workflow Explainer di eduwebmu bisa menjelaskan isi workflow n8n dalam bahasa yang mudah dibaca. Pakai penjelasannya sebagai bahan awal daftar integrasi di checklist di atas.

Pertanyaan yang sering diajukan

Kenapa workflow saya tiba-tiba error padahal tidak ada yang saya ubah?

Salah satu penyebab yang sering terlewat adalah penyedia API mempensiunkan versi yang dipakai workflow kamu, atau versi default akun kamu berganti. Kode dan pengaturan kamu sama, tetapi aturan di sisi penyedia sudah berubah.

Apa arti respons 410 Gone dari sebuah API?

Artinya sumber daya yang diminta sudah tidak tersedia dan kondisinya kemungkinan permanen. GitHub, misalnya, mengirim 410 Gone untuk permintaan yang menyebut versi API yang sudah ditutup. Mengulang permintaan yang sama tidak akan menolong.

Apakah n8n otomatis memperbarui versi node di workflow lama?

Tidak. Menurut dokumentasi n8n, workflow yang disimpan dengan node versi 1 tetap memakai versi 1 walaupun versi 2 sudah terbit. Workflow baru selalu memakai versi node terbaru.

Berapa lama versi API lama biasanya masih didukung?

Tergantung vendor. GitHub mendukung versi lama selama 24 bulan setelah versi baru rilis, Shopify mendukung tiap versi stabil minimal 12 bulan, dan Meta menjamin tiap versi Graph API berjalan minimal dua tahun.

Apa beda deprecated dan retired?

Deprecated berarti masih berfungsi tetapi tidak disarankan dan sudah punya tanggal pensiun. Retired berarti sudah tidak bisa dipakai, sehingga permintaan ke versi atau model itu gagal.

Perlukah saya selalu menulis versi API di node HTTP Request?

Saya sarankan ya, bila API tersebut mendukungnya. GitHub, Stripe, dan Meta sama-sama menyarankan menyebut versi secara eksplisit supaya integrasi tidak ikut berubah ketika versi default bergeser.

Sumber dan referensi

Semua sumber diakses 2 November 2026.

  1. 1.n8n Blog, "API Versioning Strategies for Stable Workflow Integrations" (22 Oktober 2026)blog.n8n.io(buka di tab baru)
  2. 2.n8n Docs, "Versioning" (versi node)docs.n8n.io(buka di tab baru)
  3. 3.n8n Docs, "Handle errors gracefully"docs.n8n.io(buka di tab baru)
  4. 4.n8n Docs, "Error Trigger"docs.n8n.io(buka di tab baru)
  5. 5.n8n Docs, "HTTP Request"docs.n8n.io(buka di tab baru)
  6. 6.GitHub Docs, "API Versions" (REST API)docs.github.com(buka di tab baru)
  7. 7.Shopify Dev, "About Shopify API versioning"shopify.dev(buka di tab baru)
  8. 8.Meta for Developers, "Graph API: Versioning"developers.facebook.com(buka di tab baru)
  9. 9.Stripe API Reference, "Versioning"docs.stripe.com(buka di tab baru)
  10. 10.Stripe Docs, "API upgrades"docs.stripe.com(buka di tab baru)
  11. 11.IETF, RFC 9745 "The Deprecation HTTP Response Header Field" (Maret 2025)rfc-editor.org(buka di tab baru)
  12. 12.IETF, RFC 8594 "The Sunset HTTP Header Field" (Mei 2019)rfc-editor.org(buka di tab baru)
  13. 13.Anthropic, "Model deprecations"platform.claude.com(buka di tab baru)
  14. 14.n8n Docs, "v3.0 Breaking changes"docs.n8n.io(buka di tab baru)

versi APIn8notomasiintegrasi

Artikel terkait