AirSync API v1 BETA 最終更新 2026-05-26
日本語 / English

AirSync API ベータ版

PMS ベンダー、運営代行会社の社内エンジニア、スマートロックなどのデバイス事業者向けに、AirSync の予約・メッセージ・AI 返信機能を HTTP API で公開しています。本ドキュメントは v1 ベータ仕様です。

BETA

この API は現在ベータ版です。仕様は予告なく変更される可能性があります。本番統合の前に最新の変更履歴とサポート窓口を確認してください。

対象者

ベース URL

BASE https://api.airsync.app/v1

正式な本番ドメインは GA リリース時に確定します。ベータ参加者には個別に検証用 URL を通知します。SDK は提供しておらず、HTTP を直接叩く設計です。

ドキュメント目次

01 — START

Quickstart

5 分で最初の API コールを叩く。curl と Node.js のサンプル付き。
02 — AUTH

認証

Bearer トークン認証、API キー発行 (パートナー商談 / 自助発行)、ローテーション。
03 — EVENTS

Webhook

Beds24 予約、LINE メッセージ、電話 AI からの Webhook 受信仕様と署名検証。
04 — READ

予約・物件

予約・物件・運用パラメータの取得 API。期間・物件・ステータスでフィルタ可能。
05 — MESSAGES

メッセージ

ゲスト会話の取得・送信・翻訳。LINE / メール / SMS チャネル対応。
06 — AI

AI 返信生成

AirSync の文脈に基づく返信生成を自社アプリから呼び出す OEM 用 API (準備中)。
07 — REF

リファレンス

HTTP ステータス、エラーコード、レート制限、バージョニング、変更履歴。

ベータ参加と API キーの取得

FOR PARTNERS

パートナー商談から取得

PMS ベンダー、運営代行会社、デバイス事業者の方は、お問い合わせフォームからご相談ください。個別契約のうえ API キーを発行します。
FOR CUSTOMERS

既存ユーザーの自助発行 (準備中)

AirSync を既に契約中のお客様は、ダッシュボードの「設定 → API」から API キーを自分で発行できます (実装中)。

公開予定エンドポイント (v1 ベータ)

バージョン エンドポイント 用途
v1GET /v1/bookings予約一覧の取得
v1GET /v1/bookings/{id}予約詳細の取得
v1GET /v1/properties物件一覧の取得
v1GET /v1/properties/{id}/params物件運用パラメータの取得
v1GET /v1/messagesメッセージ一覧の取得
v1POST /v1/sendメッセージ送信
v1POST /v1/messages/{id}/translateメッセージ翻訳
v1POST /webhook/beds24/bookingBeds24 予約 Webhook 受信
v1POST /callbackLINE メッセージ Webhook 受信
準備中POST /v1/ai/replyAI 返信生成 (OEM 用)

次のステップ