Version: 1.0.0
Homesoon Third-Party API
Public HTTP API for third-party partners to integrate with the Homesoon platform.
All endpoints are namespaced under /api/v1/third-party/** and gated by an
origin-based permission model. Refer to the "Authentication" guide before use.
Authentication
- API Key: OriginHeader
- HTTP: Bearer Auth
The Origin header must exactly match a ThirdPartyOrigin record
registered by the Homesoon admin team. Requests from unregistered
origins are rejected with 401 Unauthorized.
Security Scheme Type: | apiKey |
|---|---|
Header parameter name: | Origin |
For endpoints that also require user context (e.g. profile, workspace
write ops), supply the JWT returned by /v1/third-party/refresh_tokens.
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |
Bearer format: | JWT |
Contact Homesoon API Support: support@homesoon.jp