REST API テンプレート

不動産リストバックエンドテンプレート
REST API — スキーマ、地理クエリ & AI ガイド

Q: Back4appとは何ですか？

Back4appは不動産リスティングアプリの背後にあるバックエンドです。RESTでは、Property、Lead、Favorite、およびX-Parse-Session-Token認証のための明確なGET/POST/PUTエンドポイントが得られます。サーバーを書く必要もホストする必要もありません。

Q: Back4appを不動産REST APIに使用する理由は何ですか？

Back4appは不動産のための仕様準備が整ったREST APIを公開しています：プロパティ、リード、およびお気に入りのための明確なGET/POST/PUT/DELETEエンドポイント；where $nearSphereによるgeo；X-Parse-Session-Token認証。HTTPを話す任意のスタックに適合し、管理されたBaaSを望むものです。

Q: REST APIのPropertyクラスとは何ですか？

Propertyは、title、description、price、address、location（GeoPoint）、beds、baths、area、propertyType、status、listedByを持つBack4appクラスです。RESTエンドポイント：GET/POST /classes/Property、GET/PUT/DELETE /classes/Property/:id。Geo：GET /classes/Property?where={"location":{"$nearSphere":{...}}}。

Q: RESTでセッショントークンをどのように送信しますか？

ログイン時に返された値を持つX-Parse-Session-Tokenヘッダーを含めます。サーバーはACLを強制するため、許可されたデータのみが返されたり変更されたりします。このヘッダーはすべての認証されたリクエストで使用してください。

Q: REST APIを通じてPropertyにフィールドを追加できますか？

はい。新しいフィールドを含むPOSTまたはPUT JSONを送信してください；Back4appの柔軟なスキーマがそれを受け入れます。ダッシュボードからフィールドを追加することもできます。マイグレーションは不要です。

Q: RESTでジオクエリを実行するにはどうすればよいですか？

GET /classes/Property?where={"location":{"$nearSphere":{"__type":"GeoPoint","latitude":lat,"longitude":lng}}}&limit=20を使用します。結果は距離で順序付けられます。

Q: RESTクライアントにリアルタイムは利用可能ですか？

Live QueriesはWebSocketを使用し、リアルタイム更新が可能です。REST専用クライアントの場合は、GETエンドポイントをポーリングするか、CRUD用にREST APIを使用し、必要に応じて別のサブスクリプションメカニズムを使用してください。

Back4app 上のプロダクション準備が整った REST API 不動産リストバックエンド：リスト、リード、お気に入り、地理クエリ、ER 図、データ辞書、JSON スキーマ、API プレイグラウンド、数分でデプロイするためのワンクリック AI エージェントプロンプト。

AIエージェントで構築

主なポイント

このページでは、プロダクション対応の不動産スキーマ、ワンクリックAIプロンプト、段階的なREST APIコードを提供します。これにより、バックエンドを構築することなく物件リストアプリを出荷できます。

数分でデプロイ — AIエージェントプロンプトを貼り付けて、物件リスト、地理検索、リードキャプチャ、お気に入り機能を備えたアプリを実行できます。
すぐに使える地理クエリ — Property.location (GeoPoint) は「私の近くの物件」と地図ベースの検索のために $nearSphere をサポートしています。
REST API-ネイティブSDK — 型付きオブジェクト、async/await、オプションのオフラインピン留め、そして新しいリスティングのためのLive Queries。
REST + GraphQL — 両方のAPIは自動生成され、ステータス、ベッド数、価格でフィルタリングできます。距離または日付でソートします。
4つのクラス — _User (組み込み)、Property、Lead (問い合わせ)、Favorite (保存されたリスティング)。

REST API不動産リスティングバックエンドテンプレートとは？

Back4appは不動産リスティングアプリに最適なバックエンドサービス(BaaS)で、管理されたバックエンド、認証、地理クエリ、13以上の技術用SDKを提供します。REST API不動産リスティングバックエンドテンプレートは、Back4app上の事前構築されたスキーマで、認証（User）、リスティング（Property）、問い合わせ（Lead）、保存された物件（Favorite）を含みます。地理クエリ、リードキャプチャ、ワンクリックAIエージェントプロンプトを取得できます。REST APIフロントエンドを接続し、数分で動作する物件リストアプリを出荷します。

最適な用途：

プロパティリスティングアプリ不動産ポータルリードキャプチャ地図ベースの検索MVPの立ち上げBaaSを不動産用に選択するチーム

概要

不動産リスティングアプリには、プロパティのCRUD、地図検索用の地理クエリ、リードキャプチャ（プロパティごとの問い合わせ）、ユーザーのお気に入りが必要です。内部では、認証、位置情報付きのプロパティ（GeoPoint）、プロパティにリンクされたリード、お気に入りとしてユーザーとプロパティをリンクする必要があります。

スキーマ（下のER図を参照）には、ユーザー、プロパティ、リード、お気に入りが含まれています。Back4app REST API SDKを使用すると、プロパティ（地理を含む）をクエリし、リードを作成し、お気に入りを管理できます — カスタムAPIレイヤーを作成することなく。

コア不動産リスティング機能

このバックエンドテンプレートには、以下の機能が標準で含まれています。

物件リスティング

タイトル、価格、住所、位置 (GeoPoint)、ベッド数、バスルーム数、ステータスを持つ物件。ステータス、価格、または地理でリストおよびフィルタリングします。

リードキャプチャ

物件へのリードリンクの名前、メール、電話、メッセージを取得します。リスティング詳細ページからのお問い合わせをキャプチャします。

保存した物件

お気に入りリンクはユーザーと物件を関連付けます。現在のユーザーのお気に入りをリストし、リスティング詳細から追加または削除します。

地理クエリ

Property.location (GeoPoint) は $nearSphere をサポートしています。ポイントの近くの物件を見つけ、距離でソートします。

ユーザーと権限

組み込みの _User; 物件の作成/更新をエージェントに制限します; リストと詳細の公開読み取り。

Back4appで不動産リスティングバックエンドを構築する理由は？

Back4appは、地理クエリとリードキャプチャを備えた準備済みのバックエンドを提供するため、RESTグルーを記述したり、認証を自分で管理したりすることなく、プロパティリスティングアプリを構築できます。

•ジオクエリとSDK: Property.location (GeoPoint) は $nearSphere をサポートしています; SDK は Property と Lead を型安全に保ちます。
•リードキャプチャとお気に入り: Lead クラスは物件ごとの問い合わせを保存します; お気に入りはユーザーと物件をリンクして保存されたリスティングを提供します。
•Live Queries: Property または Favorite の変更を購読して、UI をリアルタイムで更新します。

すべてのスタックに対して同じスキーマとAPI — 後でクライアントを切り替えてもバックエンドを変更する必要はありません。

コアの利点

迅速に出荷し、アプリに集中できる本番環境向けの不動産バックエンド。

迅速に出荷、バックエンドコード不要

REST & GraphQL API と準備されたスキーマ — アプリを接続して開始。

すぐに使えるジオクエリ

$nearSphere を使用してポイント近くの物件を見つけ、距離でソート。

リードキャプチャ

リードクラスは名前、メール、電話、メッセージ、および物件ポインタを保存。

組み込みの認証

ユーザーのサインアップ、ログイン、およびセッション管理; お気に入りとリスト管理を制限。

オフラインで動作

ローカルピン留めにより、物件とお気に入りがオフラインで利用可能になり、再接続時に同期。

数分でデプロイ

AIエージェントを使用して、このテンプレートから不動産アプリを作成およびデプロイ。

試してみる準備はできましたか？

Back4app AIエージェントに不動産リスティングのバックエンドを作成させ、REST API フロントエンドを接続し、デプロイします — すべて単一のプロンプトから。

AIエージェントで構築 APIプレイグラウンドを試す

無料で開始 — 月50件のAIエージェントプロンプト、クレジットカード不要

技術スタック

この不動産リスティングテンプレートを支えるすべてを一目で。

フロントエンド

REST API

バックエンド

Back4app

データベース

MongoDB

認証

認証とアクセス制御

API

REST & GraphQL

デプロイメント

AIエージェント / ダッシュボード

ER図

REST API不動産リスティングデータモデルのためのエンティティ-リレーションシップ図。

ER図

図のソースを表示

Mermaid

erDiagram
    _User {
        String objectId PK
        String username
        String email
        String password
        Date createdAt
        Date updatedAt
    }

    Property {
        String objectId PK
        String title
        String description
        Number price
        String address
        GeoPoint location
        Number beds
        Number baths
        Number area
        String propertyType
        String status
        Pointer listedBy FK
        Date createdAt
        Date updatedAt
    }

    Lead {
        String objectId PK
        String name
        String email
        String phone
        String message
        Pointer property FK
        Date createdAt
        Date updatedAt
    }

    Favorite {
        String objectId PK
        Pointer user FK
        Pointer property FK
        Date createdAt
        Date updatedAt
    }

    _User ||--o{ Property : "listedBy"
    _User ||--o{ Favorite : "user"
    Property ||--o{ Lead : "property"
    Property ||--o{ Favorite : "property"

統合フロー

Auth-to-CRUDシーケンス: あなたのREST APIアプリがBack4appと通信する方法 — ログイン、プロパティをクエリ（ジオ付き）、リードを作成、お気に入りを管理。

ER図

図のソースを表示

Mermaid

sequenceDiagram
  participant User
  participant App as REST API App
  participant Back4app as Back4app Cloud

  User->>App: Login
  App->>Back4app: Authenticate (username, password)
  Back4app-->>App: Session token
  App-->>User: Logged in

  User->>App: Load data
  App->>Back4app: Query Property and Lead
  Back4app-->>App: List of Property / Lead
  App-->>User: Show list

  User->>App: Create or update
  App->>Back4app: Save Property
  Back4app-->>App: Property (objectId)
  App-->>User: Updated list

データ辞書

スキーマ内のすべてのクラスの完全なフィールドリファレンス。

フィールド	タイプ	説明	必須
objectId	String	Auto-generated unique identifier	自動
title	String	Listing title
description	String	Full listing description	—
price	Number	Asking or rental price	—
address	String	Street address	—
location	GeoPoint	Lat/lng for geo-queries and map display	—
beds	Number	Number of bedrooms	—
baths	Number	Number of bathrooms	—
area	Number	Area in sq ft or sq m	—
propertyType	String	e.g. house, apartment, land	—
status	String	e.g. for_sale, for_rent, sold	—
listedBy	Pointer<_User>	User who created the listing	—
createdAt	Date	Auto-generated creation timestamp	自動
updatedAt	Date	Auto-generated last-update timestamp	自動

14 フィールドが Property にあります

セキュリティと権限

ACL とクラスレベルの権限がこの不動産スキーマ内のデータをどのように保護するか。

プロパティと公開読み取り

プロパティリストと詳細の公開読み取りを許可し、作成/更新/削除を認証されたユーザー（例：リスティングエージェント）に制限します。

クラスレベルの権限

CLP はクラスごとに作成/読み取り/更新/削除を制限します。リードの作成は公開可能ですが、Favorite と Property の書き込みは通常認証を必要とします。

ポインタベースの関係

_UserにリンクするlistedByプロパティ; Favoriteはユーザーとプロパティをリンクします。必要に応じてCloud Codeを使用して所有権を強制します。

スキーマ (JSON)

生のJSONスキーマ定義 — Back4appアプリにコピーして使用するか、API経由でインポートします。

JSON

{
  "classes": [
    {
      "className": "Property",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "title": {
          "type": "String",
          "required": true
        },
        "description": {
          "type": "String",
          "required": false
        },
        "price": {
          "type": "Number",
          "required": false
        },
        "address": {
          "type": "String",
          "required": false
        },
        "location": {
          "type": "GeoPoint",
          "required": false
        },
        "beds": {
          "type": "Number",
          "required": false
        },
        "baths": {
          "type": "Number",
          "required": false
        },
        "area": {
          "type": "Number",
          "required": false
        },
        "propertyType": {
          "type": "String",
          "required": false
        },
        "status": {
          "type": "String",
          "required": false
        },
        "listedBy": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "Lead",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "name": {
          "type": "String",
          "required": true
        },
        "email": {
          "type": "String",
          "required": true
        },
        "phone": {
          "type": "String",
          "required": false
        },
        "message": {
          "type": "String",
          "required": false
        },
        "property": {
          "type": "Pointer",
          "targetClass": "Property",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "Favorite",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "user": {
          "type": "Pointer",
          "targetClass": "_User",
          "required": false
        },
        "property": {
          "type": "Pointer",
          "targetClass": "Property",
          "required": false
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    },
    {
      "className": "_User",
      "fields": {
        "objectId": {
          "type": "String",
          "required": false
        },
        "username": {
          "type": "String",
          "required": true
        },
        "email": {
          "type": "String",
          "required": true
        },
        "password": {
          "type": "String",
          "required": true
        },
        "createdAt": {
          "type": "Date",
          "required": false
        },
        "updatedAt": {
          "type": "Date",
          "required": false
        }
      }
    }
  ]
}

AIエージェントで構築

このテンプレートから実際の不動産リスティングアプリを構築するためにBack4app AIエージェントを使用します: フロントエンド、バックエンド（このスキーマ、認証、地理クエリ、およびAPI）を作成し、デプロイします — 手動設定は不要です。

Back4app AIエージェント

構築の準備ができました

Back4appでこの正確なスキーマと動作で不動産リストアプリを作成してください。

スキーマ:
1. _User（Back4app組み込み）: username（String、必須）、email（String、必須）、password（String、必須）；objectId、createdAt、updatedAt（システム）。
2. Property: title（String、必須）、description（String）、price（Number）、address（String）、location（GeoPoint）、beds（Number）、baths（Number）、area（Number）、propertyType（String）、status（String；例 for_sale、for_rent、sold）、listedBy（_UserへのPointer）；objectId、createdAt、updatedAt（システム）。
3. Lead: name（String、必須）、email（String、必須）、phone（String）、message（String）、property（PropertyへのPointer）；objectId、createdAt、updatedAt（システム）。
4. Favorite: user（_UserへのPointer）、property（PropertyへのPointer）；objectId、createdAt、updatedAt（システム）。

セキュリティ:
- 認証済みユーザーのみがPropertyとFavoriteの作成/更新/削除ができるようACLを設定；Propertyのリストと詳細は公開読み取り可。Lead作成は公開または認証必須に可能。
- Class-Level Permissionsで認証済みユーザーのみがFavoriteを管理；PropertyとLeadは必要に応じて。

認証:
- サインアップ（username、email、password）とログイン；ログアウト/セッション対応。

動作:
- Property（リスト担当）とFavoriteの完全なCRUD。
- Propertyに紐づくLead（問い合わせ）の作成；物件別または現在のユーザーのリスト別にLeadを一覧。
- ジオクエリ：location（GeoPoint）と$nearSphere、limitでポイント近くの物件を検索。
- status、beds、baths、価格帯、propertyTypeでPropertyをフィルタ。
- オプション：新規リストやお気に入り変更のリアルタイムLive Queries。

成果物:
- 上記スキーマ、ACL、必要なCloud CodeでBack4appアプリを作成。
- フロントエンドを生成してこのバックエンドに接続；アプリをエンドツーエンドで実行可能にデプロイ。

REST APIでバックエンドを公開。物件一覧、ジオクエリ、リード作成、お気に入り管理のcURL例を提供。

下のボタンを押して、このテンプレートのプロンプトが事前に入力された状態でエージェントを開きます。

数分でデプロイ月に50の無料プロンプトクレジットカードは不要

APIプレイグラウンド

不動産スキーマのためにRESTおよびGraphQLエンドポイントを試してください。上記のサンプルデータからのレスポンス — Back4appアカウントは必要ありません。

プレイグラウンドを読み込んでいます…

このテンプレートと同じスキーマを使用します。

ステップバイステップ REST API 統合

REST APIアプリからBack4appバックエンドに接続し、Back4app REST API SDKを使用します。

ステップ1: Back4app REST API SDKをインストール
スタックにBack4app SDKを追加します（例：npm、pubspec、またはパッケージマネージャー）。
text
1
```
# Use fetch, axios, or any HTTP client
```
ステップ2：アプリでBack4appを初期化します
アプリの起動時にApp IDとサーバーURLを使用してBack4app SDKを初期化します。
text
1
2
3
4
5
```
BASE_URL = "https://parseapi.back4app.com"
Headers:
  X-Parse-Application-Id: YOUR_APP_ID
  X-Parse-JavaScript-Key: YOUR_KEY
  Content-Type: application/json
```

ステップ3：プロパティをクエリします（オプションのジオ付き）

SDKを使用してプロパティオブジェクトを取得します。"近く"または地図結果のためにジオクエリを使用します。

Bash

# GET list
curl -X GET "https://parseapi.back4app.com/classes/Property?where=%7B%22status%22%3A%22for_sale%22%7D&order=-createdAt" \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-JavaScript-Key: YOUR_KEY"

# Geo: where={"location":{"$nearSphere":{"__type":"GeoPoint","latitude":40.7,"longitude":-74}}}

ステップ4：リード（問い合わせ）を作成します

名前、メール、電話、メッセージ、およびプロパティポインタを使用してリードを作成します。

Bash

curl -X POST "https://parseapi.back4app.com/classes/Lead" \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-JavaScript-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Jane","email":"[email protected]","property":{"__type":"Pointer","className":"Property","objectId":"<id>"}}'

ステップ5：お気に入りを管理します

お気に入り（ユーザー + プロパティ）を追加または削除します。現在のユーザーのお気に入りをリストします。

Bash

# GET my favorites (with session token)
curl -X GET "https://parseapi.back4app.com/classes/Favorite?where=%7B%22user%22%3A%7B%22__type%22%3A%22Pointer%22%2C%22className%22%3A%22_User%22%2C%22objectId%22%3A%22<userId>%22%7D%7D" \
  -H "X-Parse-Application-Id: YOUR_APP_ID" \
  -H "X-Parse-Session-Token: <sessionToken>"

状態管理の統合

アプリの状態層（例：コンテキスト、ストア、またはサービス）に Back4app SDK を統合します。

完全なデータモデル

型安全なシリアル化のために完全なプロパティ/リード/お気に入りモデルをコピーします（例：クラス、インターフェース、または型定義）。

text

// JSON response shape (REST classes/Property, classes/Lead, classes/Favorite)
interface Property {
  objectId: string;
  title: string;
  description?: string;
  price?: number;
  address?: string;
  location?: { __type: string; latitude: number; longitude: number };
  beds?: number;
  baths?: number;
  area?: number;
  propertyType?: string;
  status?: string;
  createdAt?: string;
  updatedAt?: string;
}

interface Lead {
  objectId: string;
  name: string;
  email: string;
  phone?: string;
  message?: string;
  property?: { __type: string; className: string; objectId: string };
  createdAt?: string;
  updatedAt?: string;
}

よくある質問

不動産リスティングバックエンドテンプレートに関する一般的な質問。

Back4appとは何ですか？

Back4appを不動産REST APIに使用する理由は何ですか？

REST APIのPropertyクラスとは何ですか？

RESTでセッショントークンをどのように送信しますか？

REST APIを通じてPropertyにフィールドを追加できますか？

RESTでジオクエリを実行するにはどうすればよいですか？

RESTクライアントにリアルタイムは利用可能ですか？

世界中の開発者に信頼されています

アプリの未来を築くコミュニティに参加しましょう

不動産リスティングアプリを作る準備はできましたか？

数分であなたの REST API プロジェクトを開始できます。クレジットカードは不要です。

AIエージェントで構築

不動産リストバックエンドテンプレートREST API — スキーマ、地理クエリ & AI ガイド

主なポイント

REST API不動産リスティングバックエンドテンプレートとは？

概要

コア不動産リスティング機能

物件リスティング

リードキャプチャ

保存した物件

地理クエリ

ユーザーと権限

Back4appで不動産リスティングバックエンドを構築する理由は？

コアの利点

迅速に出荷、バックエンドコード不要

すぐに使えるジオクエリ

リードキャプチャ

組み込みの認証

オフラインで動作

数分でデプロイ

試してみる準備はできましたか？

技術スタック

ER図

統合フロー

データ辞書

セキュリティと権限

プロパティと公開読み取り

クラスレベルの権限

ポインタベースの関係

スキーマ (JSON)

AIエージェントで構築

APIプレイグラウンド

ステップバイステップ REST API 統合

ステップ1: Back4app REST API SDKをインストール

ステップ2：アプリでBack4appを初期化します

ステップ3：プロパティをクエリします（オプションのジオ付き）

ステップ4：リード（問い合わせ）を作成します

ステップ5：お気に入りを管理します

状態管理の統合

完全なデータモデル

よくある質問

世界中の開発者に信頼されています

不動産リスティングアプリを作る準備はできましたか？

不動産リストバックエンドテンプレート
REST API — スキーマ、地理クエリ & AI ガイド