Version: 1.0.0
Homesoon Third-Party API
Homesoon プラットフォームと連携するサードパーティパートナー向けの公開 HTTP API です。
すべてのエンドポイントは /api/v1/third-party/** 配下にあり、Origin ベースの
パーミッションモデルによって保護されています。ご利用前に「認証」ガイドをご確認ください。
認証
- API Key: OriginHeader
- HTTP: Bearer Auth
Origin ヘッダーは、Homesoon 管理チームが登録した ThirdPartyOrigin
レコードと完全に一致する必要があります。未登録の Origin からのリクエストは
401 Unauthorized で拒否されます。
セキュリティスキーム種別: | apiKey |
|---|---|
ヘッダーパラメータ名: | Origin |
ユーザーコンテキストも必要なエンドポイント(プロフィール、ワークスペースの
書き込み操作など)では、/v1/third-party/refresh_tokens が返す JWT を
指定してください。
セキュリティスキーム種別: | http |
|---|---|
HTTP 認可スキーム: | bearer |
Bearer 形式: | JWT |
お問い合わせ Homesoon API サポート: support@homesoon.jp