API Indonesia Kini Punya Community Node untuk n8n

API Indonesia sekarang tersedia sebagai community node n8n melalui package n8n-nodes-api-indonesia. Node ini memberi pilihan resource dan operation di editor n8n, jadi workflow untuk API yang didukung tidak perlu dirangkai dari HTTP Request manual.

Versi package saat artikel ini diterbitkan adalah 0.2.4. Versi terbaru selalu tersedia di halaman npm.

Demo di atas memakai Manual Trigger dan node API Indonesia untuk mengambil gempa terkini. Satu eksekusi menghasilkan 15 item yang bisa diteruskan ke node lain.

Resource yang tersedia

Node versi pertama mencakup 24 resource:

• Wilayah dan data lokal: Wilayah, Kodepos, Plates, dan UMP.
• Pendidikan dan layanan publik: Sekolah, Kampus, Rumah Sakit, dan Libur.
• Ibadah dan kalender: Sholat, Quran, Alkitab, dan Hijriah.
• Lingkungan: Gempa, Cuaca, Peringatan Dini, dan Astronomi.
• Ekonomi dan regulasi: Kurs, Kurs BI, OJK Invest, Halal, dan BPOM.
• Pencarian dan utilitas: KBBI, Validasi, dan Util.

Pilihan field berubah mengikuti resource dan operation. Contohnya, pencarian sekolah meminta kata kunci, jadwal sholat meminta kota serta tanggal, sedangkan riwayat gempa menyediakan rentang tanggal.

Sebelum memasang

Siapkan:

1. Instance n8n self-hosted yang mengizinkan pemasangan community node dari npm.
2. Akses Owner atau Admin di n8n.
3. Akun API Indonesia yang emailnya sudah terverifikasi.

Paket ini belum boleh dianggap tersedia di n8n Cloud sampai tercantum sebagai verified community node. Panduan instalasi di bawah ditujukan untuk n8n self-hosted.

1. Pasang community node

1. Buka Settings di n8n.
2. Pilih Community Nodes.
3. Klik Install.
4. Masukkan nama package berikut:

n8n-nodes-api-indonesia

5. Baca dan setujui peringatan community node, lalu klik Install.

Untuk mengunci versi yang dipakai, masukkan n8n-nodes-api-indonesia@0.2.4. Gunakan nama package tanpa nomor versi jika ingin memasang versi terbaru yang tersedia di npm.

2. Buat API key

1. Masuk ke dashboard API Indonesia.
2. Selesaikan verifikasi email jika dashboard masih memintanya.
3. Buka menu API Keys lalu klik Buat Key Baru.
4. Beri nama yang menjelaskan pemakaiannya, misalnya n8n Production.
5. Salin key yang diawali aip_live_.

API key hanya ditampilkan sekali. Simpan sebagai credential n8n dan jangan menaruhnya di field biasa, catatan workflow, screenshot, atau source code.

3. Hubungkan credential di n8n

1. Tambahkan node API Indonesia ke workflow.
2. Pada Credential to connect with, pilih Create new credential.
3. Pilih tipe API Indonesia API.
4. Tempel API key ke field API Key.
5. Biarkan Base URL berisi https://use.apiindonesia.id.
6. Simpan credential.

Credential tersebut menambahkan header x-api-key pada setiap request. Satu credential dapat dipakai ulang di beberapa workflow sesuai pengaturan akses credential pada instance n8n Anda.

4. Jalankan workflow gempa pertama

1. Tambahkan Manual Trigger.
2. Sambungkan ke node API Indonesia.
3. Pilih credential yang baru dibuat.
4. Pilih Resource: Gempa.
5. Pilih Operation: Get Latest Earthquakes.
6. Klik Execute workflow.

Output berupa item JSON. Data itu bisa diteruskan ke Telegram, WhatsApp, Slack, database, spreadsheet, atau node pemrosesan lain yang tersedia di instance n8n Anda.

Contoh workflow lain

• Tarik daftar provinsi dengan Wilayah > Get All Provinces, lalu masukkan hasilnya ke database atau spreadsheet.
• Ambil jadwal sholat berdasarkan kabupaten/kota dan tanggal, lalu kirim pengingat terjadwal.
• Cari sekolah, kampus, atau rumah sakit dari form internal.
• Pantau data gempa dan peringatan dini dengan Schedule Trigger.
• Periksa data BPOM atau sertifikasi halal sebagai bagian dari proses pemeriksaan produk.

Kuota dan keamanan

Request dari n8n tetap dihitung berdasarkan plan API Indonesia yang terhubung ke API key. Periksa penggunaan dan sisa kuota di dashboard, terutama sebelum mengaktifkan workflow terjadwal dengan frekuensi tinggi.

Buat key terpisah untuk n8n agar key dapat dicabut tanpa mengganggu aplikasi lain. Jika key pernah masuk log, screenshot, atau repository, cabut key tersebut dan buat yang baru.

Referensi

• Package n8n-nodes-api-indonesia di npm
• Source code di GitHub
• Dokumentasi API Indonesia
• Dashboard dan API Keys
• Panduan resmi instalasi community node n8n

Mulai dengan membuat API key di dashboard, pasang package di n8n, lalu jalankan operation pertama dari resource yang Anda perlukan.