クイックスターターズ
TypeScriptのバックエンドを構築する方法は？

46min
はじめに
このチュートリアルでは、Back4appを使用してTypeScriptアプリケーションの完全なバックエンドを構築する方法を学びます。
データベース管理、Cloud Code Functions、RESTおよびGraphQL API、ユーザー認証、リアルタイムクエリ（ライブクエリ）など、Back4appの重要な機能を統合する方法を説明し、TypeScriptコードからアクセスできる安全でスケーラブルで堅牢なバックエンドを作成します。
また、Back4appの迅速なセットアップと直感的な環境が、サーバーやデータベースを手動で構成するのに比べて、時間と労力を大幅に削減できることを確認します。
その過程で、Cloud Jobsを使用したタスクのスケジューリングや、外部統合のためのWebhookの設定など、主要な機能に関する実践的な経験を得ることができます。
このチュートリアルの終わりまでには、この基本的なセットアップを本番環境に適したアプリケーションに拡張する準備が整い、必要に応じてカスタムロジックやサードパーティAPIを簡単に組み込むことができるようになります。
前提条件
このチュートリアルを完了するには、次のものが必要です:
Back4appアカウントと新しいBack4appプロジェクト
 Back4appの始め方。
アカウントを持っていない場合は、無料で作成できます。上記のガイドに従ってプロジェクトを準備してください。
基本的なTypeScript開発環境
 Node.js（バージョン14以上）がインストールされていることを確認してください。 npm init -yを使用して新しいTypeScriptプロジェクトを作成し、その後 npm install -D typescript @types/nodeを実行します。
TypeScriptまたはJavaScriptの基本的な知識
 TypeScript公式ドキュメント。
TypeScriptが初めての場合は、公式ドキュメントまたは初心者向けのチュートリアルを確認してから始めてください。
始める前に、これらの前提条件がすべて整っていることを確認してください。Back4appプロジェクトが設定され、ローカルのTypeScript環境が準備されていると、より簡単に進めることができます。
ステップ1 – Back4appプロジェクトの設定
新しいプロジェクトを作成する
Back4appでTypeScriptバックエンドを構築する最初のステップは、新しいプロジェクトを作成することです。まだ作成していない場合は、次の手順に従ってください:
Back4appアカウントにログインする.
「新しいアプリ」ボタンをクリックする あなたのBack4appダッシュボードで。
アプリに名前を付ける（例：「TypeScript-Backend-Tutorial」）。
﻿
プロジェクトが作成されると、Back4appダッシュボードにリスト表示されます。このプロジェクトは、このチュートリアルで説明するすべてのバックエンド設定の基盤となります。
Parse SDKを接続する
Back4appは、データを管理し、リアルタイム機能を提供し、ユーザー認証を処理するためにParseプラットフォームに依存しています。TypeScriptアプリケーションをBack4appに接続するには、parse npmパッケージをインストールし、Back4appダッシュボードの資格情報で初期化します。
Parseキーを取得する:
Back4appダッシュボードで、アプリの「アプリ設定」または「セキュリティとキー」セクションに移動して、アプリケーションIDとJavaScriptキー}を見つけます。また、ParseサーバーURL（通常はhttps://parseapi.back4app.com)も見つかります。
﻿
Parse SDKをインストールする あなたのTypeScriptプロジェクトに:
Bash
npm install parse
npm install parse
﻿
Yarnを使用している場合は、次のようにインストールできます:
Bash
yarn add parse
yarn add parse
﻿
必要に応じて型定義をインストールすることもできます:
Bash
npm install -D @types/parse
npm install -D @types/parse
﻿
TypeScriptアプリケーションでParseを初期化する:
通常、あなたはファイルを作成します（例：parseConfig.ts）をあなたのsrcディレクトリに:
src/parseConfig.ts
// src/parseConfig.ts
import Parse from 'parse';

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

export default Parse;
// src/parseConfig.ts
import Parse from 'parse';

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

export default Parse;
﻿
このファイルは、TypeScriptコードの他の場所でParseをインポートするたびに、特定のBack4appインスタンスに接続するように事前に設定されていることを保証します。
このステップを完了することで、TypeScriptプロジェクトとBack4appバックエンドの間に安全な接続が確立されました。すべてのリクエストとデータトランザクションは、このSDKを通じて安全にルーティングされ、手動のRESTまたはGraphQL呼び出しの複雑さが軽減されます（必要に応じてそれらを使用することもできます）。
ステップ2 – データベースの設定
データの保存とクエリ
Back4appプロジェクトが設定され、Parse SDKがTypeScriptコードベースに統合されたので、データの保存と取得を開始できます。レコードを作成する最も簡単な方法は、Parse.Objectクラスを使用することです:
TypeScript
// Example: Create a Todo item

import Parse from './parseConfig';

async function createTodoItem(title: string, isCompleted: boolean) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);
  todo.set('isCompleted', isCompleted);

  try {
    const savedTodo = await todo.save();
    console.log('Todo saved successfully:', savedTodo);
    return savedTodo;
  } catch (error) {
    console.error('Error saving Todo:', error);
  }
}

// Example: Query all Todo items

async function fetchTodos() {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  try {
    const results = await query.find();
    console.log('Fetched Todo items:', results);
    return results;
  } catch (error) {
    console.error('Error fetching Todos:', error);
  }
}
// Example: Create a Todo item

import Parse from './parseConfig';

async function createTodoItem(title: string, isCompleted: boolean) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);
  todo.set('isCompleted', isCompleted);

  try {
    const savedTodo = await todo.save();
    console.log('Todo saved successfully:', savedTodo);
    return savedTodo;
  } catch (error) {
    console.error('Error saving Todo:', error);
  }
}

// Example: Query all Todo items

async function fetchTodos() {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  try {
    const results = await query.find();
    console.log('Fetched Todo items:', results);
    return results;
  } catch (error) {
    console.error('Error fetching Todos:', error);
  }
}
﻿
また、Back4appのREST APIエンドポイントを使用することもできます:
Curl
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APPLICATION_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Buy groceries", "isCompleted": false}' \
  https://parseapi.back4app.com/classes/Todo
﻿
Back4appはGraphQLインターフェースも提供しています:
GraphQL
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
mutation {
  createTodo(input: {
    fields: {
      title: "Clean the house"
      isCompleted: false
    }
  }) {
    todo {
      objectId
      title
      isCompleted
    }
  }
}
﻿
これらの多様なオプションにより、Parse SDK、REST、またはGraphQLを通じて、開発プロセスに最も適した方法でデータ操作を統合できます。
スキーマ設計とデータ型
デフォルトでは、Parseは スキーマを動的に作成することを許可しますが、より多くの制御のためにBack4appダッシュボードでクラスとデータ型を定義することもできます。
「データベース」セクションに移動します あなたのBack4appダッシュボードで。
新しいクラスを作成します（例：「Todo」）そして、タイトル（String）やisCompleted（Boolean）などの関連するカラムを追加します。
新しいクラスを作成
﻿
Back4appはさまざまなデータ型もサポートしています: String, Number, Boolean, Object, Date, File, Pointer, Array, Relation, GeoPoint, そして Polygon. 各フィールドに適切な型を選択できます。希望する場合は、TypeScriptコードからオブジェクトを最初に保存するときにParseがこれらのカラムを自動的に作成することもできます。
カラムを作成
﻿
Back4appは、データモデルの設計を手助けするAIエージェントを提供しています。
AIエージェントを開く アプリダッシュボードまたはメニューから。
データモデルを説明する 簡単な言葉で（例：「新しいToDoアプリをback4appで完全なクラススキーマで作成してください。」）。
AIエージェントにスキーマを作成させる. 
﻿
AIエージェントを使用すると、データアーキテクチャの設定にかかる時間を節約し、アプリケーション全体での一貫性を確保できます。
リレーショナルデータ
リレーショナルデータがある場合、例えば、複数のカテゴリオブジェクトが複数のTodoアイテムを指している場合、ポインタまたはリレーションをParseで使用できます。例えば、カテゴリへのポインタを追加することができます。
TypeScript
// Linking a Task to a Category with a pointer
async function createTaskForCategory(categoryObjectId: string, title: string) {
  const todo = new Parse.Object('Todo');

  // Construct a pointer to the category
  const categoryPointer = new Parse.Object('Category');
  categoryPointer.id = categoryObjectId;

  // Set fields
  todo.set('title', title);
  todo.set('category', categoryPointer);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error creating Task with category relationship:', err);
  }
}
// Linking a Task to a Category with a pointer
async function createTaskForCategory(categoryObjectId: string, title: string) {
  const todo = new Parse.Object('Todo');

  // Construct a pointer to the category
  const categoryPointer = new Parse.Object('Category');
  categoryPointer.id = categoryObjectId;

  // Set fields
  todo.set('title', title);
  todo.set('category', categoryPointer);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error creating Task with category relationship:', err);
  }
}
﻿
クエリを実行する際、ポインタデータも含めることができます。
TypeScript
const query = new Parse.Query('Todo');
query.include('category');
const todosWithCategory = await query.find();
const query = new Parse.Query('Todo');
query.include('category');
const todosWithCategory = await query.find();
﻿
このinclude('category')呼び出しは、各Todoとともにカテゴリの詳細を取得し、リレーショナルデータをシームレスにアクセス可能にします。
ライブクエリ
リアルタイムの更新のために、Back4appは ライブクエリ を提供しています。あなたのTypeScriptコードでは、特定のクラスの変更にサブスクライブできます:
ライブクエリを有効にする あなたのBack4appダッシュボードのアプリの サーバー設定 の下で。 “ライブクエリ” がオンになっていることを確認してください。
ライブクエリサブスクリプションを初期化する あなたのコードで:
src/parseConfig.ts
// src/parseConfig.ts
import Parse from 'parse';

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

// Live Query's subdomain:
Parse.liveQueryServerURL = 'wss://YOUR_SUBDOMAIN_HERE.b4a.io';

export default Parse;
// src/parseConfig.ts
import Parse from 'parse';

// Replace the placeholders with your Back4app credentials
Parse.initialize('YOUR_APPLICATION_ID', 'YOUR_JAVASCRIPT_KEY');
Parse.serverURL = 'https://parseapi.back4app.com';

// Live Query's subdomain:
Parse.liveQueryServerURL = 'wss://YOUR_SUBDOMAIN_HERE.b4a.io';

export default Parse;
﻿
TypeScript
import Parse from './parseConfig';

async function subscribeToTodos(callback: (event: string, todo: Parse.Object) => void) {
  const query = new Parse.Query('Todo');
  const subscription = await query.subscribe();

  subscription.on('create', (newTodo) => {
    console.log('New Todo created:', newTodo);
    callback('create', newTodo);
  });

  subscription.on('update', (updatedTodo) => {
    console.log('Todo updated:', updatedTodo);
    callback('update', updatedTodo);
  });

  subscription.on('delete', (deletedTodo) => {
    console.log('Todo deleted:', deletedTodo);
    callback('delete', deletedTodo);
  });

  return subscription;
}
import Parse from './parseConfig';

async function subscribeToTodos(callback: (event: string, todo: Parse.Object) => void) {
  const query = new Parse.Query('Todo');
  const subscription = await query.subscribe();

  subscription.on('create', (newTodo) => {
    console.log('New Todo created:', newTodo);
    callback('create', newTodo);
  });

  subscription.on('update', (updatedTodo) => {
    console.log('Todo updated:', updatedTodo);
    callback('update', updatedTodo);
  });

  subscription.on('delete', (deletedTodo) => {
    console.log('Todo deleted:', deletedTodo);
    callback('delete', deletedTodo);
  });

  return subscription;
}
﻿
サブスクリプションを行うことで、新しいTodoが作成、更新、または削除されるたびにリアルタイム通知を受け取ります。この機能は、複数のユーザーが最新のデータをリフレッシュせずに見る必要があるコラボレーションや動的なアプリに特に価値があります。
ステップ3 – ACLとCLPによるセキュリティの適用
Back4appのセキュリティメカニズム
Back4appは、 アクセス制御リスト (ACL) と クラスレベルの権限 (CLP) を提供することで、セキュリティを真剣に考えています。これらの機能により、オブジェクトまたはクラスごとにデータの読み取りや書き込みを制限でき、認可されたユーザーのみがデータを変更できるようにします。
﻿
アクセス制御リスト (ACL)
ACLは個々のオブジェクトに適用され、どのユーザー、役割、または一般の人々が読み書き操作を行えるかを決定します。例えば:
TypeScript
async function createPrivateTodo(title: string, ownerUser: Parse.User) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);

  // Create an ACL granting read/write access only to the owner
  const acl = new Parse.ACL(ownerUser);
  acl.setPublicReadAccess(false);
  acl.setPublicWriteAccess(false);

  todo.setACL(acl);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error saving private todo:', err);
  }
}
async function createPrivateTodo(title: string, ownerUser: Parse.User) {
  const Todo = Parse.Object.extend('Todo');
  const todo = new Todo();
  todo.set('title', title);

  // Create an ACL granting read/write access only to the owner
  const acl = new Parse.ACL(ownerUser);
  acl.setPublicReadAccess(false);
  acl.setPublicWriteAccess(false);

  todo.setACL(acl);

  try {
    return await todo.save();
  } catch (err) {
    console.error('Error saving private todo:', err);
  }
}
﻿
オブジェクトを保存すると、それには指定されたユーザー以外の誰も読み取りまたは変更できないACLがあります。
ACLを編集
﻿
クラスレベルの権限 (CLP)
CLPはクラス全体のデフォルトの権限を管理し、クラスが一般に読み取り可能または書き込み可能か、特定の役割のみがアクセスできるかどうかを決定します。
Back4appダッシュボードに移動する, アプリを選択し、データベースセクションを開きます。
クラスを選択する（例：「Todo」）。
クラスレベルの権限タブを開きます。 
「読み取りまたは書き込みに対して認証が必要」や「公開に対してアクセス不可」などのデフォルトを設定します。
﻿
これらの権限は基本を設定し、ACLは個々のオブジェクトの権限を微調整します。堅牢なセキュリティモデルは通常、CLP（広範な制限）とACL（オブジェクトごとの細かい制限）を組み合わせます。詳細については、アプリセキュリティガイドライン。﻿
ステップ4 – クラウドファンクションの作成とデプロイ
クラウドコードは、Parse Server環境の機能で、サーバー側でカスタムJavaScript/TypeScriptコードを実行できるようにします – サーバーやインフラストラクチャを管理する必要はありません。クラウドコードを書くことで、Back4appバックエンドを追加のビジネスロジック、バリデーション、トリガー、およびParse Server上で安全かつ効率的に実行される統合で拡張できます。
どのように機能するか
Cloud Codeを書くとき、通常は関数、トリガー、および必要なNPMモジュールを main.js (または app.js, またはTypeScriptからトランスパイルされたもの) に配置します。このファイルは、Parse Server環境内で実行されるBack4appプロジェクトにデプロイされます。これらの関数とトリガーはサーバー上で実行されるため、機密ロジックを処理したり、敏感なデータを処理したり、バックエンド専用のAPI呼び出しを行ったりすることを信頼できます。これらは、クライアントに直接公開したくないプロセスです。
Back4appアプリのすべてのCloud Codeは、Back4appによって管理されるParse Server内で実行されるため、サーバーのメンテナンス、スケーリング、またはプロビジョニングについて心配する必要はありません。main.jsファイルを更新してデプロイするたびに（TypeScriptからコンパイル可能）、実行中のParse Serverは最新のコードで更新されます。
JS
// main.js example
// 1. Import necessary modules
const axios = require('axios');

// 2. Define a custom Cloud Function
Parse.Cloud.define('fetchExternalData', async (request) => {
  const url = request.params.url;
  if (!url) {
    throw new Error('URL parameter is required');
  }
  const response = await axios.get(url);
  return response.data;
});

// 3. Example of a beforeSave trigger
Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw new Error('Todo must have a title');
  }
});
// main.js example
// 1. Import necessary modules
const axios = require('axios');

// 2. Define a custom Cloud Function
Parse.Cloud.define('fetchExternalData', async (request) => {
  const url = request.params.url;
  if (!url) {
    throw new Error('URL parameter is required');
  }
  const response = await axios.get(url);
  return response.data;
});

// 3. Example of a beforeSave trigger
Parse.Cloud.beforeSave('Todo', (request) => {
  const todo = request.object;
  if (!todo.get('title')) {
    throw new Error('Todo must have a title');
  }
});
﻿
NPMモジュールをインストールして使用する能力により、Cloud Codeは非常に柔軟になり、外部APIとの統合、データ変換の実行、または複雑なサーバーサイドロジックの実行が可能になります。
典型的な使用例
ビジネスロジック: 例えば、複数のオブジェクトプロパティを集計してユーザーのゲームスコアを計算し、そのデータを自動的に保存することができます。
データ検証: 特定のフィールドが存在することや、ユーザーがレコードを保存または削除する前に正しい権限を持っていることを確認します。
トリガー: データが変更されたときにアクションを実行します（例：ユーザーがプロフィールを更新したときに通知を送信）。
統合: サードパーティのAPIやサービスと接続します。例えば、Cloud Codeから直接支払いゲートウェイ、Slack通知、またはメールマーケティングプラットフォームと統合することができます。
セキュリティ強化: Cloud Code関数内で入力パラメータを検証およびサニタイズすることで、追加のセキュリティ層を追加します。
関数をデプロイする
以下は、クライアントから送信されたテキスト文字列の長さを計算するシンプルなCloud Code関数です:
main.js
// main.js

Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
// main.js

Parse.Cloud.define('calculateTextLength', async (request) => {
  const { text } = request.params;
  if (!text) {
    throw new Error('No text provided');
  }
  return { length: text.length };
});
﻿
デプロイは、Back4app CLI:
1 - CLIをインストールする：
Linux/MacOSの場合:
Bash
curl https://raw.githubusercontent.com/back4app/parse-cli/back4app/installer.sh | sudo /bin/bash
curl https://raw.githubusercontent.com/back4app/parse-cli/back4app/installer.sh | sudo /bin/bash
﻿
Windowsの場合：
b4a.exeファイルをリリースページからダウンロードします。
2 - アカウントキーを設定する：﻿
Bash
b4a configure accountkey
b4a configure accountkey
﻿
3 - クラウドコードをデプロイする：
Bash
b4a deploy
b4a deploy
﻿
ダッシュボードを通じてデプロイする：
アプリのダッシュボードで、クラウドコード > 関数に移動します。
関数をmain.jsエディタにコピー/ペーストします。
「デプロイ」をクリックします。
﻿
関数の呼び出し
Parse SDKを使用したTypeScript環境から:
TypeScript
import Parse from './parseConfig';

async function getTextLength(text: string) {
  try {
    const result = await Parse.Cloud.run('calculateTextLength', { text });
    console.log('Text length:', result.length);
  } catch (err) {
    console.error('Error calling cloud function:', err);
  }
}
import Parse from './parseConfig';

async function getTextLength(text: string) {
  try {
    const result = await Parse.Cloud.run('calculateTextLength', { text });
    console.log('Text length:', result.length);
  } catch (err) {
    console.error('Error calling cloud function:', err);
  }
}
﻿
REST経由でも呼び出すことができます:
Curl
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
curl -X POST \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello Back4app"}' \
  https://parseapi.back4app.com/functions/calculateTextLength
﻿
またはGraphQL経由で:
GraphQL
mutation {
  calculateTextLength(input: {
    text: "Hello GraphQL"
  }) {
    result
  }
}
mutation {
  calculateTextLength(input: {
    text: "Hello GraphQL"
  }) {
    result
  }
}
﻿
この柔軟性により、TypeScriptアプリケーションやRESTまたはGraphQLをサポートする他のクライアントにカスタムロジックを統合することができます。
ステップ5 – ユーザー認証の設定
Back4appにおけるユーザー認証
Back4appは、Parse Userクラスを認証の基盤として活用しています。デフォルトでは、Parseはパスワードのハッシュ化、セッショントークン、セキュアストレージを処理します。これは、複雑なセキュリティフローを手動で設定する必要がないことを意味します。
ユーザー認証の設定
TypeScriptでは、新しいユーザーを作成できます:
TypeScript
import Parse from './parseConfig';

async function signUpUser(username: string, password: string, email: string) {
  const user = new Parse.User();
  user.set('username', username);
  user.set('password', password);
  user.set('email', email);

  try {
    await user.signUp();
    console.log('User signed up successfully!');
  } catch (error) {
    console.error('Error signing up user:', error);
  }
}
import Parse from './parseConfig';

async function signUpUser(username: string, password: string, email: string) {
  const user = new Parse.User();
  user.set('username', username);
  user.set('password', password);
  user.set('email', email);

  try {
    await user.signUp();
    console.log('User signed up successfully!');
  } catch (error) {
    console.error('Error signing up user:', error);
  }
}
﻿
既存のユーザーにログインする:
TypeScript
async function logInUser(username: string, password: string) {
  try {
    const user = await Parse.User.logIn(username, password);
    console.log('User logged in:', user);
  } catch (error) {
    console.error('Error logging in user:', error);
  }
}
async function logInUser(username: string, password: string) {
  try {
    const user = await Parse.User.logIn(username, password);
    console.log('User logged in:', user);
  } catch (error) {
    console.error('Error logging in user:', error);
  }
}
﻿
REST経由でのログインは次のようになります:
Bash
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
curl -X GET \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-REST-API-Key: YOUR_REST_API_KEY" \
  -G \
  --data-urlencode 'username=alice' \
  --data-urlencode 'password=secret123' \
  https://parseapi.back4app.com/login
﻿
セッション管理
ログインに成功すると、Parseはユーザーオブジェクトに保存される セッショントークン を作成します。TypeScriptコード内で、現在ログインしているユーザーにアクセスできます:
TypeScript
const currentUser = Parse.User.current();
if (currentUser) {
  console.log('Currently logged-in user:', currentUser.getUsername());
} else {
  console.log('No user is logged in');
}
const currentUser = Parse.User.current();
if (currentUser) {
  console.log('Currently logged-in user:', currentUser.getUsername());
} else {
  console.log('No user is logged in');
}
﻿
Parseはバックグラウンドでトークンベースのセッションを自動的に処理しますが、手動で管理または取り消すこともできます。これは、ログアウトする必要があるときに便利です:
TypeScript
await Parse.User.logOut();
await Parse.User.logOut();
﻿
ソーシャルログイン統合
Back4appとParseは、追加のパッケージをインストールするか、既存のアダプターを使用することで、GoogleやFacebookなどの人気のあるOAuthプロバイダーと統合できます。たとえば、Facebook App IDを設定し、Parse.FacebookUtils.logIn()を使用することで、Facebookログインを設定できます。詳細な手順は異なるため、ソーシャルログインドキュメント。﻿
TypeScript
const facebookLogin = async () => {
  try {
    const user = await Parse.FacebookUtils.logIn('email');
    console.log(user.existed() ? 'User logged in' : 'User signed up and logged in');
  } catch (error) {
    console.error('Error logging in with Facebook:', error);
  }
};
const facebookLogin = async () => {
  try {
    const user = await Parse.FacebookUtils.logIn('email');
    console.log(user.existed() ? 'User logged in' : 'User signed up and logged in');
  } catch (error) {
    console.error('Error logging in with Facebook:', error);
  }
};
﻿
メール確認とパスワードリセット
メール確認とパスワードリセットを有効にするには:
メール設定に移動します。
メール確認を有効にすることで、新しいユーザーが自分のメールアドレスの所有権を確認できるようにします。
送信元アドレスを設定する、メールテンプレート、および必要に応じてカスタムドメインを設定します。
これらの機能は、ユーザーがメールの所有権を確認し、安全なパスワード回復方法を提供することで、アカウントのセキュリティとユーザーエクスペリエンスを向上させます。
ステップ6 – ファイルストレージの取り扱い
ファイルのアップロードと取得
Parseには、ファイルアップロードを処理するためのParse.Fileクラスが含まれており、Back4appが安全に保存します:
TypeScript
import Parse from './parseConfig';

async function uploadImage(file: File) {
  // file is typically from a local path or some input; in Node, you might handle buffers
  const name = file.name;
  const parseFile = new Parse.File(name, file);

  try {
    const savedFile = await parseFile.save();
    console.log('File saved:', savedFile.url());
    return savedFile.url();
  } catch (err) {
    console.error('Error uploading file:', err);
  }
}
import Parse from './parseConfig';

async function uploadImage(file: File) {
  // file is typically from a local path or some input; in Node, you might handle buffers
  const name = file.name;
  const parseFile = new Parse.File(name, file);

  try {
    const savedFile = await parseFile.save();
    console.log('File saved:', savedFile.url());
    return savedFile.url();
  } catch (err) {
    console.error('Error uploading file:', err);
  }
}
﻿
データベースのオブジェクトにファイルを添付するには、次のようにします:
TypeScript
async function createPhotoObject(file: File) {
  const Photo = Parse.Object.extend('Photo');
  const photo = new Photo();
  const parseFile = new Parse.File(file.name, file);
  photo.set('imageFile', parseFile);

  return await photo.save();
}
async function createPhotoObject(file: File) {
  const Photo = Parse.Object.extend('Photo');
  const photo = new Photo();
  const parseFile = new Parse.File(file.name, file);
  photo.set('imageFile', parseFile);

  return await photo.save();
}
﻿
ファイルのURLを取得するのは簡単です:
TypeScript
const imageFile = photo.get('imageFile');
const imageUrl = imageFile.url();
const imageFile = photo.get('imageFile');
const imageUrl = imageFile.url();
﻿
このimageUrlを使用して、保存されたファイルを表示または処理することができます。
ファイルのセキュリティ
Parse Serverは、ファイルアップロードのセキュリティを管理するための柔軟な設定を提供します。次の例は、誰がサーバーにファイルをアップロードできるかを制御するための権限を設定する方法を示しています:
Text
{
    "fileUpload": {
        "enableForPublic": true,
        "enableForAnonymousUser": true,
        "enableForAuthenticatedUser": true
    }
}
{
    "fileUpload": {
        "enableForPublic": true,
        "enableForAnonymousUser": true,
        "enableForAuthenticatedUser": true
    }
}
﻿
enableForPublic: trueに設定すると、認証状況に関係なく、誰でもファイルをアップロードできるようになります。
enableForAnonymousUser: 匿名ユーザー（サインアップしていないユーザー）がファイルをアップロードできるかどうかを制御します。有効にすると、一時的またはゲストユーザーがファイルをアップロードできます。
enableForAuthenticatedUser: 認証されたユーザーのみがファイルをアップロードできるかどうかを指定します。これは、信頼できるユーザーのみがこの機能にアクセスできるようにするために理想的です。
ステップ7 – クラウドジョブを使用したタスクのスケジューリング
クラウドジョブ
クラウドジョブはBack4appでバックエンド上のルーチン作業をスケジュールして実行することができます。例えば、古いデータのクリーンアップや毎日の要約メールの送信などです。典型的なクラウドジョブは次のようになります:
JS
// main.js

Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  // For example, remove todos older than 30 days
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
// main.js

Parse.Cloud.job('cleanupOldTodos', async (request) => {
  const Todo = Parse.Object.extend('Todo');
  const query = new Parse.Query(Todo);

  // For example, remove todos older than 30 days
  const now = new Date();
  const THIRTY_DAYS = 30 * 24 * 60 * 60 * 1000;
  const cutoff = new Date(now - THIRTY_DAYS);

  query.lessThan('createdAt', cutoff);

  try {
    const oldTodos = await query.find({ useMasterKey: true });
    await Parse.Object.destroyAll(oldTodos, { useMasterKey: true });
    return `Deleted ${oldTodos.length} old Todos.`;
  } catch (err) {
    throw new Error('Error during cleanup:' + err.message);
  }
});
﻿
クラウドコードをデプロイする 新しいジョブと共に（CLIまたはダッシュボード経由で）。
Back4appダッシュボードに移動する > アプリ設定 > サーバー設定 > バックグラウンドジョブ.
ジョブをスケジュールする 毎日またはニーズに合った間隔で実行されるように。
クラウドジョブのスケジューリング
﻿
クラウドジョブは、バックグラウンドメンテナンスやその他の定期的なプロセスを自動化することを可能にします。手動での介入は必要ありません。
ステップ8 – Webhookの統合
Webhookは、特定のイベントが発生するたびに、Back4appアプリが外部サービスにHTTPリクエストを送信できるようにします。これは、決済ゲートウェイ（例：Stripe）、メールマーケティングツール、または分析プラットフォームなどのサードパーティシステムと統合するために強力です。
Webhookの設定に移動し、Back4appダッシュボード > その他 > WebHooksに進み、Add Webhookをクリックします。
エンドポイントを設定します（例：https://your-external-service.com/webhook-endpoint）。
トリガーを設定して、Back4appのクラスやCloud Code関数でどのイベントがWebhookを発火させるかを指定します。
Webhookの追加
﻿
例えば、新しいTodoが作成されるたびにSlackチャンネルに通知したい場合：
受信ウェブフックを受け入れるSlackアプリを作成します。
SlackのウェブフックURLをコピーします。
Back4appダッシュボードで、「Todoクラスの新しいレコード」イベントのためにそのSlack URLをエンドポイントとして設定します。
必要に応じてカスタムHTTPヘッダーやペイロードを追加することもできます。
トリガーのbeforeSaveやafterSaveでカスタムHTTPリクエストを行うことで、Cloud CodeでWebhooksを定義することもできます。
BeforeSave WebHook
﻿
ステップ9 – Back4app管理パネルの探索
「Back4app管理アプリ」は、非技術的なユーザーがCRUD操作を行い、コードを書くことなく日常的なデータタスクを処理するために設計されたウェブベースの管理インターフェースです。これは、データベース管理、カスタムデータ管理、およびエンタープライズレベルの操作を効率化するモデル中心で、ユーザーフレンドリーなインターフェースを提供します。
管理アプリの有効化
「アプリダッシュボード > その他 > 管理アプリ」に移動し、「管理アプリを有効にする」ボタンをクリックして有効にします。
管理アプリを有効にする
﻿
最初の管理ユーザーを作成します（ユーザー名/パスワード）を作成すると、自動的に新しい役割（B4aAdminUser）とクラス（B4aSetting、B4aMenuItem、B4aCustomField）がアプリのスキーマに生成されます。
﻿
管理インターフェースにアクセスするためのサブドメインを選択し、セットアップを完了します。
﻿
ログイン あなたが新しい管理アプリのダッシュボードにアクセスするために作成した管理者資格情報を使用してください。
﻿
一度有効にすると、Back4app管理アプリは、Parseダッシュボードやバックエンドコードを直接使用することなく、データベースのレコードを簡単に表示、編集、または削除することができます。設定可能なアクセス制御を使用することで、データを管理するための明確でポイントアンドクリックの方法が必要なチームメンバーやクライアントとこのインターフェースを安全に共有できます。
結論
この包括的なチュートリアルに従うことで、あなたは:
安全なバックエンドを作成しました Back4app上のTypeScriptアプリケーション用。
データベースを構成しました クラススキーマ、データ型、関係を使用して。
リアルタイムクエリを統合しました （ライブクエリ）で即時データ更新。
セキュリティ対策を適用しました ACLとCLPを使用してデータアクセスを保護および管理。
Cloud Codeを実装しました サーバー側でカスタムビジネスロジックを実行するための関数。
ユーザー認証を設定しました メール確認とパスワードリセットをサポート。
ファイルのアップロードを管理しました および取得、オプションのファイルセキュリティコントロール付き。
Cloud Jobsをスケジュールしました 自動化されたバックグラウンドタスクのために。
Webhookを使用しました 外部サービスと統合するために。
Back4app管理パネルを探索しました データ管理のために。
堅牢なTypeScript環境と強力なBack4appバックエンドを持つことで、機能豊富でスケーラブルかつ安全なアプリケーションを開発するための準備が整いました。さらに高度な機能を探求し、ビジネスロジックを統合し、Back4appの力を活用してサーバーとデータベースの管理にかかる無数の時間を節約してください。コーディングを楽しんでください！
次のステップ
本番環境に対応したTypeScriptアプリを構築する このバックエンドを拡張して、より複雑なデータモデル、キャッシング戦略、パフォーマンス最適化を処理します。
高度な機能を統合する 専門的な認証フロー、役割ベースのアクセス制御、または外部API（支払いゲートウェイなど）を含みます。
Back4appの公式ドキュメントをチェックする 高度なセキュリティ、パフォーマンス調整、ログ分析についての詳細な情報を得るために。
他のチュートリアルを探る リアルタイムチャットアプリケーション、IoTダッシュボード、または位置情報サービスに関するものです。ここで学んだ技術をサードパーティのAPIと組み合わせて、複雑な実世界のアプリケーションを作成できます。
﻿
更新日 24 Jan 2025
このページは役に立ちましたか？
JavaScript用のバックエンドを構築する方法は？
ExpressJSのバックエンドを構築する方法は？