メインコンテンツへスキップ
開発者向けドキュメントを表示しています
このドキュメントは、Base44 開発者プラットフォームで作業する開発者向けです。アプリエディタ内のバックエンド関数については、Using Integrationsを参照してください。
バックエンド関数を使用すると、安全で隔離された環境でカスタムバックエンドコードを実行できます。ブラウザで実行すべきでないビジネスロジックの実装、保護された認証情報でのサードパーティ API への接続、webhook の処理、カスタムエンドポイントでのアプリの拡張に関数を使用してください。 バックエンド関数はモダンな TypeScript ランタイムである Deno 上で実行されます。フロントエンドから SDK を使用して関数を呼び出すと、認証が自動的に処理されます。各関数には、webhook と外部インテグレーション用の独自の HTTP エンドポイントも提供されます。 関数は自動化を使用して自動的に実行することもできます。特定の時刻に実行されるように関数をスケジュールしたり、レコードの作成、更新、削除などのデータベースイベントに応じてトリガーしたりできます。
各プロジェクトは最大 50 個のバックエンド関数をサポートします。

​
関数の作成

プロジェクトの functions ディレクトリに TypeScript ファイルとしてバックエンド関数を作成します。デフォルトでは functions ディレクトリは base44/functions/ ですが、プロジェクト構成でパスをカスタマイズできます。 各関数は、entry.ts または entry.js ファイルを持つ独自のサブディレクトリ内にあります:
functions
<function-name>
entry.ts
CLI は、関数ルートに対する相対ディレクトリパスを関数名として使用します。例えば、functions/sendWelcomeEmail/entry.ts は sendWelcomeEmail という名前の関数を作成します。整理のためにサブディレクトリに関数をネストすることもできます。functions/email/send/entry.ts は email/send という名前の関数を作成します。

​
構成ファイルの追加

カスタム関数名や自動化などの高度なニーズには、function.jsonc ファイルを追加します:
functions
<function-name>
entry.ts
function.jsonc
構成ファイルは、関数の名前とエントリーポイントを定義します: 
{
  "name": "sendWelcomeEmail",
  "entry": "entry.ts",
}
プロパティ説明
nameオプション。関数の一意の識別子。SDK または HTTP 経由で呼び出すときに使用されます。デフォルトは functions ルートに対する相対ディレクトリパス。
entry関数コードを含むファイル。
automationsオプション。スケジュールまたはデータベースイベントに応じて関数を実行する自動化構成の配列。詳細は自動化を参照してください。

​
entry.ts

コードファイルには関数のロジックが含まれます。関数は Deno.serve() ラッパーを使用し、Response オブジェクトを返す必要があります: 
import { createClientFromRequest } from "npm:@base44/sdk";

Deno.serve(async (req) => {
  try {
    const base44 = createClientFromRequest(req);
    const user = await base44.auth.me();

    if (!user) {
      return Response.json({ error: "Unauthorized" }, { status: 401 });
    }

    const { name } = await req.json();

    return Response.json({
      message: `Hello, ${name || user.full_name}!`,
    });
  } catch (error) {
    return Response.json({ error: error.message }, { status: 500 });
  }
});

​
ローカルでテスト

base44 dev を使用して関数をローカルで実行し、デプロイせずに変更をテストします。詳細はローカル開発を参照してください。

​
関数のデプロイ

すべてのプロジェクトリソースを一度にプッシュするには、functions deploy または deploy で関数をデプロイします。functions deploy <names...> で名前で特定の関数をデプロイしたり、--force を使用してローカルに見つからないリモート関数を削除したりできます。 デプロイされた関数をローカルプロジェクトにダウンロードするには、functions pull を使用してください。現在デプロイされているものを確認するには、functions list を使用してください。

​
関数の呼び出し

SDK を使用してフロントエンドからバックエンド関数を呼び出すか、webhook と外部インテグレーション用に HTTP 経由で呼び出します。

​
SDK 経由

フロントエンドから関数を呼び出すには base44.functions.invoke() を使用してください。SDK は認証を自動的に処理し、現在のユーザーの認証情報を関数に渡します。 
import { base44 } from "@/api/base44Client";

const response = await base44.functions.invoke("sendWelcomeEmail", {
  name: "Alice",
});

​
HTTP 経由

デプロイされた各関数には、以下に HTTP エンドポイントが提供されます: 
https://<your-app-domain>/functions/<function-name>
これは以下に便利です:
  • Webhook: Stripe や GitHub などの外部サービスからのコールバックを受信。
  • 外部インテグレーション: 他のシステムがアプリと対話できるようにします。
  • テスト: cURL や Postman などのツールで関数を直接呼び出し。
使用例 
curl -X POST https://your-app.base44.app/functions/sendWelcomeEmail \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice"}'
直接 HTTP (cURL や webhook など) で関数を呼び出す場合、認証済みのユーザーコンテキストはありません。これらの場合、すべての操作に asServiceRole を使用してください。

​
関数内で SDK を使用する

バックエンド関数内では、Base44 SDK を介してアプリのデータ、認証、インテグレーションにアクセスできます。受信リクエストからクライアントを作成するには createClientFromRequest() を使用してください。 認証コンテキストは関数の呼び出し方法によって異なります:
  • フロントエンドから SDK 経由で呼び出されたとき: ユーザーの認証が自動的に渡されます。base44.auth.me() で現在のユーザーにアクセスし、その権限で操作を実行できます。管理者レベルの操作には asServiceRole を使用してください。
  • 直接 HTTP (cURL、webhook、外部サービス) 経由で呼び出されたとき: 認証済みユーザーはないため、すべての操作に asServiceRole を使用してください。

​
サードパーティ API に接続

バックエンド関数は、サードパーティ API に接続するいくつかの方法の 1 つです。リクエストを完全に制御する必要がある場合、または API キーを環境変数として安全に保存したい場合に最適です。CLI から環境変数を設定するには secrets set を使用してください。

​
ログの表示

ローカル開発中、関数の出力は logs コマンドを必要とせずに直接ターミナルに出力されます。 デプロイされた関数については、logs コマンドでログを表示してください。ログにはコンソール出力、エラー、タイミング情報が含まれます。関数名または時間範囲でフィルタリングできます。AI コーディングエージェントを使用している場合、base44-troubleshooter skill がこれらのログを自動的に取得して分析できます。

​
TypeScript 型

関数構成から TypeScript 型を生成して、SDK コード内の関数名に対する型安全性とオートコンプリートを取得します。ダイナミック型について詳しく学んでください。

​
関連項目

  • Automations: 関数をスケジュールするか、データベースイベントでトリガー
  • functions module: 関数を呼び出すための SDK リファレンス
  • createClientFromRequest: バックエンド関数でクライアントを作成
  • functions deploy: ローカル関数を Base44 にデプロイ
  • functions pull: デプロイされた関数をローカルプロジェクトにダウンロード
  • functions list: すべてのデプロイされた関数をリスト
  • functions delete: デプロイされた関数を削除
  • logs: 関数ログを表示
  • exec: スタンドアロンスクリプトから分離して関数をテスト
このページは AI を使用して翻訳されました。最も正確で最新の情報については、英語版 を参照してください。