Quickstarters
Cara Membangun Backend untuk Deno?

34min
Pendahuluan
Dalam tutorial ini, Anda akan belajar bagaimana membangun backend untuk Deno menggunakan Back4App. 
Kami akan melalui setiap langkah untuk mengintegrasikan fitur utama Back4App—database, API REST, otentikasi pengguna, penyimpanan file, dan kueri langsung—ke dalam lingkungan Deno. 
Anda akan melihat bagaimana berkomunikasi dengan Back4App melalui endpoint REST dan membuat infrastruktur lengkap tanpa mengelola server sendiri.
Ketika Anda menggunakan Back4App, Anda dapat melewati konfigurasi server dengan Deno secara manual, menghemat waktu dan usaha. 
Anda akan fokus pada penulisan kode yang lebih sederhana, berkat pustaka standar Deno dan pendekatan modern. 
Pada akhir panduan ini tentang cara membangun backend untuk Deno, Anda akan memiliki jalur yang jelas untuk mengintegrasikan keamanan tingkat lanjut, kode cloud, dan tugas terjadwal ke dalam aplikasi Deno Anda.
Setelah Anda menyelesaikan tutorial ini, Anda akan dapat menjalankan server, menangani REST API, mengintegrasikan otentikasi pengguna, menyimpan file, dan menjadwalkan tugas dengan mudah.
Anda juga akan memahami cara mengelola data Anda dengan pendekatan fetch Deno menggunakan REST API Back4App.
Prasyarat
Akun Back4app dan proyek Back4app baru
Memulai dengan Back4app.
Jika Anda tidak memiliki akun, Anda dapat membuatnya secara gratis. Gunakan tautan di atas untuk menyiapkan proyek Anda.
Instal Deno
Anda dapat mendapatkan Deno di https://deno.land. Instal Deno di sistem operasi Anda dan konfirmasikan dengan deno --version.
Keterampilan dasar dengan konsep Deno
Seperti modul, sistem file, deno run --allow-net, atau cara mengimpor modul aplikasi dari pustaka standar.
Pengetahuan dasar tentang REST API
Kami akan menggunakan panggilan fetch dan jenis konten header untuk penanganan data, jadi pastikan Anda mengetahui dasar-dasar REST dan JSON.
Pastikan Anda memiliki prasyarat ini sebelum memulai. Memiliki proyek Back4App Anda yang dikonfigurasi dan lingkungan Deno lokal Anda yang berjalan akan memungkinkan Anda mengikuti tutorial ini dengan lancar.
Langkah 1 – Membuat Proyek Baru di Back4App dan menghubungkan
Buat Proyek Baru
Dasar untuk backend Deno Anda adalah proyek Back4App. Jika Anda belum membuat satu:
Masuk ke akun Back4App Anda.
Klik tombol “Aplikasi Baru” di dasbor Back4App Anda.
Beri nama aplikasi Anda (misalnya, “Deno-Backend-Tutorial”).
﻿
Setelah proyek Anda siap, itu akan muncul di dasbor Back4App Anda. Proyek ini adalah tempat Anda akan mengatur basis data, keamanan, dan API.
Sambungkan ke Back4App melalui REST
Karena kami tidak memiliki Parse SDK untuk Deno, kami akan menggunakan endpoint REST API Back4App. Anda dapat menemukan ID Aplikasi, Kunci API REST, dan URL Server di Pengaturan Aplikasi atau Keamanan & Kunci aplikasi Anda.
﻿
Sepanjang tutorial ini, kita akan menggunakan fetch untuk mengirim permintaan dari Deno ke Back4App. Pastikan untuk menyertakan kunci API dan jenis konten header di setiap panggilan.
Langkah 2 – Menyiapkan Database
Dalam langkah ini, Anda akan membuat model data di Back4App dan berinteraksi dengannya menggunakan REST API dari Deno.
Membuat Model Data
Pergi ke bagian “Database” di dasbor Back4App Anda.
Klik “Buat Kelas Baru” dan beri nama, misalnya, “Todo.”
Tambahkan kolom yang relevan (misalnya, judul (String), isCompleted (Boolean)).
Buat Kelas Baru
﻿
Anda juga dapat membiarkan Parse untuk membuat kolom ini secara otomatis saat data disimpan.
Membuat Model Data dengan Agen AI
Agen AI Back4App dapat merancang skema Anda:
Buka Agen AI di dasbor Back4App Anda.
Deskripsikan model data Anda (misalnya, “Buat kelas Todo dengan judul, deskripsi, dan field isCompleted.”).
Izinkan agen untuk menghasilkan skema secara otomatis.
﻿
Ini membantu Anda mengelola skema yang lebih kompleks dengan cepat.
Membaca dan Menulis Data Menggunakan REST API
Dari Deno, Anda dapat menjalankan server dengan memanggil endpoint REST menggunakan fetch. Sebagai contoh, untuk membuat Todo:
Text
// file called createTodo.ts
export async function createTodoItem(title: string, isCompleted: boolean) {
  const url = "https://parseapi.back4app.com/classes/Todo";
  const body = JSON.stringify({ title, isCompleted });

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body,
  });

  if (!response.ok) {
    throw new Error(`Error saving Todo: ${response.statusText}`);
  }
  const result = await response.json();
  return result;
}
// file called createTodo.ts
export async function createTodoItem(title: string, isCompleted: boolean) {
  const url = "https://parseapi.back4app.com/classes/Todo";
  const body = JSON.stringify({ title, isCompleted });

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body,
  });

  if (!response.ok) {
    throw new Error(`Error saving Todo: ${response.statusText}`);
  }
  const result = await response.json();
  return result;
}
﻿
Untuk mengambil Todos:
Text
// file called fetchTodos.ts
export async function fetchTodos() {
  const url = "https://parseapi.back4app.com/classes/Todo";

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
    },
  });

  if (!response.ok) {
    throw new Error(`Error fetching Todos: ${response.statusText}`);
  }
  const result = await response.json();
  return result;
}
// file called fetchTodos.ts
export async function fetchTodos() {
  const url = "https://parseapi.back4app.com/classes/Todo";

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
    },
  });

  if (!response.ok) {
    throw new Error(`Error fetching Todos: ${response.statusText}`);
  }
  const result = await response.json();
  return result;
}
﻿
Anda dapat menjalankan ini dengan:
Bash
deno run --allow-net createTodo.ts
deno run --allow-net createTodo.ts
﻿
Membaca dan Menulis Data Menggunakan API GraphQL
Back4App juga menyediakan endpoint GraphQL: https://parseapi.back4app.com/graphql
Text
// file called createTodoGraphQL.ts
export async function createTodoGraphQL(title: string) {
  const mutation = `
    mutation {
      createTodo(input: {
        fields: {
          title: "${title}"
          isCompleted: false
        }
      }) {
        todo {
          objectId
          title
          isCompleted
        }
      }
    }
  `;

  const response = await fetch("https://parseapi.back4app.com/graphql", {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ query: mutation }),
  });

  const result = await response.json();
  return result;
}
// file called createTodoGraphQL.ts
export async function createTodoGraphQL(title: string) {
  const mutation = `
    mutation {
      createTodo(input: {
        fields: {
          title: "${title}"
          isCompleted: false
        }
      }) {
        todo {
          objectId
          title
          isCompleted
        }
      }
    }
  `;

  const response = await fetch("https://parseapi.back4app.com/graphql", {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ query: mutation }),
  });

  const result = await response.json();
  return result;
}
﻿
Bekerja dengan Live Queries (Opsional)
Live Queries memperbarui Anda secara real-time, tetapi Deno tidak memiliki pustaka Parse LiveQuery bawaan. Anda masih dapat mengatur fitur Live Query di dasbor Back4App Anda untuk klien lain atau menggunakan WebSocket di Deno untuk berlangganan secara manual. Untuk detail lebih lanjut, lihat dokumentasi Live Query.
Langkah 3 – Menerapkan Keamanan dengan ACL dan CLP
Ikhtisar
ACL (Access Control Lists) dan CLP (Class-Level Permissions) Back4App melindungi data Anda. Gunakan CLP untuk menetapkan aturan default untuk seluruh kelas. Kemudian gunakan ACL untuk pembatasan tingkat objek.
Mengatur Izin Tingkat Kelas
Buka Database bagian di dasbor Back4App Anda.
Pilih Kelas (misalnya, “Todo”).
Pergi ke Izin Tingkat Kelas tab.
Aktifkan atau nonaktifkan akses baca/tulis untuk publik atau untuk pengguna yang terautentikasi sesuai kebutuhan.
﻿
Mengonfigurasi ACL
Saat membuat atau memperbarui objek melalui REST, Anda dapat menyertakan atribut ACL dalam tubuh permintaan. Misalnya:
Text
const body = JSON.stringify({
  title: "Private Task",
  ACL: {
    "*": { "read": false, "write": false },
    "ROLE:Admins": { "read": true, "write": true },
  }
});
const body = JSON.stringify({
  title: "Private Task",
  ACL: {
    "*": { "read": false, "write": false },
    "ROLE:Admins": { "read": true, "write": true },
  }
});
﻿
Contoh ini hanya memungkinkan peran “Admins” untuk membaca atau menulis. Akses publik dimatikan.
Langkah 4 – Menulis Fungsi Cloud Code
Mengapa Cloud Code
Cloud Code adalah tempat Anda menyimpan logika sisi server yang aman. Anda tidak mengelola server sendiri. Anda dapat menambahkan validasi atau pemicu untuk kelas tertentu.
Contoh Fungsi Cloud Code
Anda dapat mendefinisikan Fungsi Cloud (dalam JavaScript) dan menerapkannya ke aplikasi Anda. Misalnya, fungsi untuk memeriksa panjang teks mungkin seperti ini:
Text
Parse.Cloud.define("calculateTextLength", async (request) => {
  const { text } = request.params;
  if (!text) {
    throw "Text parameter is required";
  }
  return { length: text.length };
});
Parse.Cloud.define("calculateTextLength", async (request) => {
  const { text } = request.params;
  if (!text) {
    throw "Text parameter is required";
  }
  return { length: text.length };
});
﻿
Penerapan
Anda dapat menerapkan kode melalui Back4App CLI atau panel Cloud Code di dasbor Back4App Anda.
NPM di Cloud Code
Anda dapat mengimpor pustaka eksternal dengan require(). Setelah diterapkan, lingkungan server akan menjalankannya. Ini berguna untuk tugas-tugas lanjutan, tetapi ingatlah bahwa menjalankannya dari Deno terpisah dari lingkungan Cloud Code Anda di Back4App.
Langkah 5 – Mengonfigurasi Autentikasi
Aktifkan Autentikasi
Back4App menggunakan kelas Pengguna Parse untuk autentikasi. Saat Anda bekerja dengan Deno, Anda dapat memanggil endpoint REST untuk mengelola pengguna.
Daftar dan Masuk menggunakan REST
Text
async function signUpUser(username: string, password: string, email: string) {
  const url = "https://parseapi.back4app.com/users";
  const body = JSON.stringify({ username, password, email });

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body,
  });

  return await response.json();
}

async function logInUser(username: string, password: string) {
  const url = `https://parseapi.back4app.com/login?username=${username}&password=${password}`;

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
    },
  });
  return await response.json();
}
async function signUpUser(username: string, password: string, email: string) {
  const url = "https://parseapi.back4app.com/users";
  const body = JSON.stringify({ username, password, email });

  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "application/json",
    },
    body,
  });

  return await response.json();
}

async function logInUser(username: string, password: string) {
  const url = `https://parseapi.back4app.com/login?username=${username}&password=${password}`;

  const response = await fetch(url, {
    method: "GET",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
    },
  });
  return await response.json();
}
﻿
Login Sosial
Anda dapat mengatur Google, Facebook, Apple, dan penyedia lainnya di Back4App. Kemudian, Anda akan memanggil endpoint khusus dengan token OAuth. Lihat dokumentasi Login Sosial Back4App untuk detail.
Langkah 6 – Menangani Penyimpanan File
Unggah dan Ambil File
Untuk mengunggah file dari Deno, gunakan permintaan POST ke https://parseapi.back4app.com/files/<FILENAME>. Sebagai contoh:
Text
async function uploadFile(fileData: Uint8Array, fileName: string) {
  const url = `https://parseapi.back4app.com/files/${fileName}`;
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "image/png",
    },
    body: fileData,
  });
  return await response.json();
}
async function uploadFile(fileData: Uint8Array, fileName: string) {
  const url = `https://parseapi.back4app.com/files/${fileName}`;
  const response = await fetch(url, {
    method: "POST",
    headers: {
      "X-Parse-Application-Id": "YOUR_APPLICATION_ID",
      "X-Parse-REST-API-Key": "YOUR_REST_API_KEY",
      "Content-Type": "image/png",
    },
    body: fileData,
  });
  return await response.json();
}
﻿
Anda kemudian dapat menyimpan URL file yang dihasilkan dalam objek kelas Anda. Metode ini sempurna untuk menyimpan gambar atau dokumen saat Anda menjalankan server di Deno.
Langkah 7 – Verifikasi Email dan Reset Kata Sandi
Ikhtisar
Verifikasi email memastikan akses yang sah. Reset kata sandi membantu pengguna mendapatkan kembali akses dengan aman.
Konfigurasi Dasbor
Aktifkan Verifikasi Email di dasbor Back4App Anda di bawah Pengaturan Email.
Sesuaikan template verifikasi Anda.
Aktifkan Reset Kata Sandi dan atur tata letak email yang Anda inginkan.
Ketika seorang pengguna mendaftar, mereka menerima tautan verifikasi jika Anda mengaktifkan verifikasi email. Untuk reset kata sandi, panggil endpoint REST POST /requestPasswordReset.
Langkah 8 – Menjadwalkan Tugas dengan Pekerjaan Cloud
Ikhtisar Pekerjaan Cloud
Pekerjaan Cloud berjalan secara berkala tanpa intervensi manusia. Misalnya, Anda dapat menghapus catatan lama setiap hari atau mengirim pengingat email rutin.
Text
Parse.Cloud.job("cleanupOldTodos", async (request) => {
  const Todo = Parse.Object.extend("Todo");
  const query = new Parse.Query(Todo);

  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now.valueOf() - THIRTY_DAYS);

  query.lessThan("createdAt", cutoff);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
Parse.Cloud.job("cleanupOldTodos", async (request) => {
  const Todo = Parse.Object.extend("Todo");
  const query = new Parse.Query(Todo);

  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now.valueOf() - THIRTY_DAYS);

  query.lessThan("createdAt", cutoff);
  const oldTodos = await query.find({ useMasterKey: true });
  await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
  return `Deleted ${oldTodos.length} old Todos.`;
});
﻿
Setelah menerapkan pekerjaan ini, Anda dapat menjadwalkannya di Pengaturan Aplikasi > Pengaturan Server > Pekerjaan Latar Belakang di dasbor Back4App Anda.
Langkah 9 – Mengintegrasikan Webhook
Definisi
Webhook adalah callback HTTP yang dipicu ketika peristiwa terjadi, seperti pembuatan atau pembaruan objek. Anda dapat mengintegrasikan dengan Slack, Stripe, atau layanan eksternal lainnya.
Konfigurasi
Buka “Lainnya” > “Webhook” di dasbor Back4App.
Klik “Tambahkan Webhook” dan berikan endpoint layanan pihak ketiga Anda.
Atur yang memicu atau kelas yang ingin Anda kirim permintaan.
Menambahkan Webhook
﻿
Ini memungkinkan sistem eksternal untuk menerima data setiap kali Anda membuat atau memodifikasi objek di Back4App.
Langkah 10 – Menjelajahi Panel Admin Back4App
Pengantar Panel Admin
Tim non-teknis dapat menggunakan panel ini untuk mengelola data secara visual. Ini menyederhanakan operasi CRUD dan tinjauan data.
Cara Mengaktifkan
Pergi ke Dasbor Aplikasi > Lainnya > Aplikasi Admin dan pilih “Aktifkan Aplikasi Admin.”
Buat Pengguna Admin untuk masuk.
Atur subdomain untuk Aplikasi Admin Anda.
Aktifkan Aplikasi Admin
﻿
Anda kemudian dapat masuk ke Aplikasi Admin untuk mengelola catatan dengan aman.
Kesimpulan
Dalam tutorial ini, Anda menemukan cara membangun backend untuk Deno di Back4App. Anda membuat model data, menangani otentikasi pengguna, mempelajari tentang ACL dan CLP untuk keamanan, dan menjadwalkan Pekerjaan Cloud.
Anda juga melihat bagaimana mengintegrasikan API eksternal melalui webhook dan bagaimana menjalankan server atau API REST dengan perintah deno run --allow-net.
Pengaturan ini membuat Anda cepat memulai tanpa mengonfigurasi sistem file atau kompleksitas pustaka standar untuk arsitektur server.
Langkah Selanjutnya:
Kembangkan aplikasi Deno Anda dengan endpoint tambahan dan logika lanjutan menggunakan Cloud Code.
Integrasikan lebih banyak layanan (misalnya, gateway pembayaran, analitik) dengan data Back4App Anda.
Rujuk dokumentasi resmi Back4App untuk tips analisis keamanan, kinerja, dan log yang lebih dalam.
Eksperimen dengan fitur real-time lanjutan atau penyimpanan deno kv, menjembatani data antara runtime Deno Anda dan lingkungan Back4App yang kuat.
Dengan pengetahuan baru Anda, Anda dapat dengan percaya diri menerapkan backend Deno yang aman, dapat diskalakan, dan kaya fitur yang didukung oleh Back4App.
Diperbarui 24 Jan 2025
Apakah halaman ini membantu Anda?
SEBELUMNYA
Cara Membangun Backend untuk Astro?
BERIKUTNYA
Cara Membangun Backend untuk Golang?