公開API

公開APIのご利用について

アクセストークンの取得までの手順として
【お宿様の場合】
1. 施設の登録を行ってください。
2. 登録した施設から公開APIの料金をお支払いください。
3. 登録した施設のマスタ設定＞公開API＞アクセストークン管理よりアクセストークンを追加してください。

【開発者の場合】
1. 施設の登録を行ってください。
2. 登録した施設のドメインとともにアクセストークンの取得についてお問い合わせください。

トークン情報に施設情報が紐付けされていますので、
対象の施設のアクセストークンを用いてAPIをご利用ください。

それぞれのリンクにあるアクセストークンの入力フォームに設定すると
CURLコマンドで内容を確認できるようになっています。

更新履歴
2025-12-23
予約のその他商品の追加についてページ番号の項目を追加しました。
省略時はこれまで通り1ページ目の商品として追加されます。
2025-11-13
予約の入金情報追加についてページ番号の項目を追加しました。
また複数ページが存在する予約で未入金金額と入金額が一致した場合
それぞれのページ毎に入金を分けて登録するように対応しました。
2025-11-05
予約詳細、予約詳細(複数取得)に予約情報の追加項目として追加保存項目を追加できるようにしました。
2025-05-12
予約詳細、予約詳細(複数取得)、予約一覧にお知らせ送付(send_news)を追加しました。
2024-11-11
予約一覧のデータ取得条件として検索方法(search_type)を追加しました。
2024-08-29
予約詳細、予約詳細(複数取得)、予約一覧に予約清掃備考(cleaning_remarks)を追加しました。
2024-08-14
予約のその他商品一覧の取得、予約のその他商品追加のAPIを追加しました。
その他商品一覧の取得、その他商品カテゴリー一覧の取得するAPIを追加しました。
2024-07-01
予約一覧、予約詳細、予約詳細(複数取得)に企画(package)の子要素を追加しました。
2023-11-06
予約のチェックイン、予約のチェックアウトに部屋IDを追加指定できるようにしました。
2023-10-11
予約詳細、予約詳細(複数取得)に扱先(agent)の子要素を追加しました。
2023-09-21
予約詳細、予約詳細(複数取得)、予約一覧に大人男人数、大人女人数を追加しました。
予約詳細、予約詳細(複数取得)に予約情報の追加項目としてフリーコメントを追加できるようにしました。
予約詳細に領収書(receipt)の子要素を追加しました。
予約詳細(複数取得)の最大件数を10件から30件に増やしました。
2023-08-16
予約詳細に「夕食」「朝食」「昼食」の料理商品IDの項目を追加しました。
予約詳細に予約の日毎の情報「夕食時間」「朝食時間」「昼食時間」を追加しました。
料理商品一覧の取得APIを追加しました。
2023-07-31
予約詳細をID指定で複数取得するAPIを追加しました。
2023-07-24
基本商品一覧の取得APIを追加しました。
予約の排他制御を行うAPIを追加しました。
2023-07-20
予約の同行者追加、更新に「年齢」「電話番号」「郵便番号」「発信地」の項目を追加しました。
2023-06-28
予約一覧と予約詳細にキャンセル日時(canceled_at)を追加しました。
2023-03-16
予約ID一覧を取得するAPIを追加しました。
2023-03-01
予約一覧に更新日時の絞り込みを追加しました。
2023-02-17
予約詳細の宿泊基本商品、その他商品、入金情報に日付を追加しました。
2023-01-19
予約一覧、予約詳細の部屋割当情報に男性、女性、子供、布団の人数を追加いたしました。
こちらStaysee上での人員割付タブに入力されている人数情報を返します。
2022-12-15
予約一覧、予約詳細に郵便番号(zip_code)を追加しました。
2022-04-14
予約の精算APIを追加いたしました。
未精算の金額がない場合に精算済みへ変更できる機能となります。
2022-02-08
予約の入金情報追加について入金日の必須設定を削除しました。
未設定の場合呼び出し時の入金日を自動的に設定するようになりました。
2021-11-11
予約詳細の同行者のface_url,passport_urlについて : が2つ連続していましたので修正しました。
2021-11-09
・予約一覧、予約詳細にpaid(精算状態)を追加しました。
・予約詳細の出力項目名を変更しました。
regular_products => reservation_regular_products
optional_products => reservation_optional_products
payments => reservation_payments
childrenの指定要素も合わせて変更しています。
またid,商品id,入金id等も追加しております。
・予約の入金情報追加APIを追加しました。
・金種一覧の取得APIを追加しました。
2021-09-13
予約詳細の出力項目に入金金額(payment_amount)を追加し
billing_amountを合計金額から入金金額を引いた請求金額に変更しました。
予約詳細に「基本商品情報」「その他商品情報」「入金情報」を取得できるよう追加しました。
2021-07-26
公開APIのアクセストークン管理機能を追加しました。
登録した施設よりアクセストークンを追加、削除することができます。
2021-04-23
予約一覧、予約詳細に下記のチェックイン、チェックアウト時刻を追加しました。 
"check_in_time": "18:00",                   // 時刻(時刻形式でない場合やデータが存在しない場合は00:00で返却されます)
"check_out_time": "20:00",                  // 時刻(時刻形式でない場合やデータが存在しない場合は23:59で返却されます)
"check_in_date_time": "2020-07-20 18:00",   // 宿泊開始日 + 時刻
"check_out_date_time": "2020-07-21 20:00",  // 宿泊終了日 + 時刻