はじめに
Homesoon サードパーティ API を使うと、パートナー企業は自社システムを Homesoon の workspace と連携し、construction・task・appointment・supervisor・Shabelabo の 音声議事録レコードを管理できます。
ベース URL
| 環境 | URL |
|---|---|
| Production | https://api.homesoon.jp/api |
| Staging | https://staging.api.homesoon.jp/api |
| Development | https://develop.api.homesoon.jp/api |
すべてのエンドポイントは /v1/third-party/ 配下にあります。
共通仕様
- レスポンスは必ず次の形式でラップされます。
{"status": "success", "data": {...}, "meta": {...}, "error": null}
- エラー時は
statusが"failure"になり、詳細がerrorに入ります。 - タイムスタンプは ISO 8601 形式・UTC です。
- ページネーションは
page（1 始まり）とpaging（1 ページあたりの件数、最大 100）を使用します。
次のステップ
- Origin を登録します — 認証 を参照してください。
POST /v1/third-party/refresh_tokensでアクセストークンを発行してみます。- 各エンドポイントの詳細は API リファレンス を参照してください。