不動産知識だけではなく、生活の視点から住まいとの出会いをつくれます。
Potager向け
あなたの地域の視点が、誰かの住まいとの出会いになる。
ポタージュでは、Potagerが物件情報を素材にしながら、犬、本、器、子育て、海、商店街のような住まいの周辺を編集できます。
現在は初期リリースのPhase 1です。外部Potagerは参加しません。 弊社が第一号Potagerとして試験運用し、本番運用前の課題を確認しています。 一般募集・一般申込はPhase 2から開始します。
複数サイトを運営する場合は、サイトごとに追加利用、API照合、導線評価を分けます。
外部URL、タイトル、コメントを登録し、Potager Galleryに活動の記録を残します。
参加費
Phase 2の一般申込では、月額利用料を申込前に税込総額で確認する。
Potagerは広告枠を買う人ではなく、住まいの周辺に意味を与える参加者です。 有料機能は日本国内に居住する個人または日本国内に所在する事業者が対象です。 Phase 1は弊社自身の試験運用に限り、外部からの参加やこのページからの一般申込は受け付けません。 Phase 2で確定する月額利用料、消費税、合計額は、有料申込の前に確認できる形で案内します。
連携手段
OGP、iframe、Widget、APIを、Potagerの技術状況に合わせて選べるようにします。
広告と紹介
Potagerサイト内広告、広告主紹介、地域の企画につながる接点を運営側が支援します。
制作支援
デザイン事務所、ライター、フォトグラファー、契約書サンプルの紹介導線を用意します。
連携の優先順位
多くのPotagerが使いやすい順に、入口を用意する。
最初から開発が必要なAPIだけに寄せず、URLを貼るだけのOGPから始め、必要に応じて埋め込みやWidgetへ進めます。
物件や記事のURLを貼るだけで、画像、タイトル、概要を表示します。
Potage側の一覧や窓を、外部サイトにそのまま埋め込みます。
テーマや表示件数を調整した小さな窓として、サイトの文脈に合わせます。
開発できるサイト向けに、公開物件を取得して独自UIで表示します。
物件の反映
気になる物件を選び、自分のサイトへ持ち帰りやすくする。
Potagerはポタージュ上で物件を見つけ、URL、埋め込み、APIのどれかで自分のサイトに反映できます。 まずは1件ずつ紹介し、慣れてきたらテーマ別の一覧や窓として並べます。
1. 物件を選ぶ
一覧や詳細ページから、記事や地域テーマに合う物件を選びます。選んだ物件はPotagerサイト側の紹介素材になります。
物件一覧を見る2. 反映方法を選ぶ
URL貼り付け、iframe、Widget、APIの順に、サイトの運用と技術状況に合わせて反映方法を選べます。
3. 導線を確認する
Potagerサイトからポタージュ詳細、SMS確認済み問い合わせへ進む流れを確認し、成果候補の土台にします。
デモの管理画面を見るAPI連携
外部サイトから、公開物件だけを取得する。
PotagerサイトごとのAPIキーと許可Originで照合します。返却される物件には、ポタージュ詳細へ戻すための `potageDetailUrl` と、画像登録完了日ベースの `timelineAt` が含まれます。APIは有効掲載だけを返します。
取得
curl -H 'x-potage-api-key: ptg_demo_kotokoto' \
'http://localhost:3100/api/v1/properties?site=kotokoto-journal'遷移
`potageDetailUrl` には `site` と `ref` が入ります。閲覧者が詳細へ移動したあと、ポタージュ内の問い合わせ送信成果につながります。
タイムライン
`publishedAt` は物件の公開日、`timelineAt` はポタージュ側の画像登録完了日です。Potagerサイトの新着表示では `timelineAt` を優先します。APIの返却順も `timelineAt` の新しい順です。
会社表示
サービス名はFxC、正式な読み・説明表記はF by Cです。会社情報には `confirmationLabel` と `confirmationHelp` が含まれます。FxC確認済みは、FxC側の確認が完了した会社だけに表示します。確認希望中・不整合・未知の状態は一般掲載として扱います。会社情報の公開キーは `confirmationHelp`, `confirmationLabel`, `id`, `name`, `slug` に制限します。会社入力にsnake_caseとcamelCaseのFxC状態が併存する場合は、値がnullでもcamelCaseキーを優先します。`fxc_id`, `fxc_confirmation_requested`, `fxc_confirmed`, `fxc_confirmed_at`, `fxc_status`, `fxcId`, `fxcConfirmationRequested`, `fxcConfirmed`, `fxcConfirmedAt`, `fxcStatus` は公開APIへ返しません。
個人情報
APIは公開物件情報だけを返します。問い合わせ者の氏名、電話番号、メールアドレス、本文はPotagerサイト向けAPIには返しません。