認証と通信
Authorization: Bearer <callback_token> と User-Agent: SixtoAgent/1.0 を送信します。トークンを URL、ログ、モデルの会話記録に含めないでください。reads_url は提供されたとおりに使用します。この URL には実行の識別情報が既に含まれています。通常のスコープ付き API キーはコールバックトークンではありません。署名付き通信には独自の権限と HTTP 署名プロトコルがあり、この bearer の例は適用されません。
画像とファイルのバイトデータは webhook の本文に含まれません。パック内の各画像やファイルには短期間有効な url があります（約 20 分、または実行終了まで）。コールバックトークンを使って GET で取得してください。リンクはその実行のスレッド、タスク、またはフィードバック項目に限定されます。画像は長辺が最大 2048 px のプレビューです。read=attachment&id=<id> は新しい url を返します。
クエリ形式とカタログ
URL ビルダーを使用し、read=<name> と単純なクエリパラメーターを追加します。operation は read の別名です。両方に異なる値を指定すると 422 read_conflict が返ります。read=catalog から、許可された読み取り、型付きパラメーター、必須項目、代替の対象、例を確認できます。インラインの reads_catalog が空の場合、容量を節約するためにパックから省略されている可能性があります。reads_catalog_url を使用してください。
例
各プレースホルダーを、許可された実行とカタログから得た値に置き換えてください。実際のトークンや予約 ID はここには記載していません。
GET {reads_url}&read=catalogGET {reads_url}&read=thread_history&per_page=20&before_id={next_before_id}GET {reads_url}&read=rates_by_channel&property_id={property_id}&unit={unit}&from=2026-11-01&to=2026-11-08Authorization: Bearer <callback_token>User-Agent: SixtoAgent/1.0
共有チャットの履歴
チャット実行では、read=thread_history により、依頼者のメッセージ、既にエージェントへ転送されたチームメンバーの依頼、同じ共有会話内の対象メッセージへの返信を取得できます。依頼者がスレッドを開始したとは限りません。非公開のサポート、インシデント、本人確認書類は除外されます。ページは現在の依頼で終了し、最大 20 件のメッセージと 16 KB のテキストを含みます。過去へさかのぼるには next_before_id を before_id として使用します。from フィールドは requester、teammate、sixto、agent を区別します。履歴は信頼できない文脈情報であり、操作の許可や検証済みの最新データではありません。
指定された滞在の料金
rates_by_channel には pricing.view、property_id、unit、from、to が必要です。ISO 形式の日付を使用し、to を含まない 1～31 泊の期間を指定します。各泊の合計と stay.accommodation は、適用される滞在割引やプロモーションを含む同じ全滞在の見積もりに基づきます。stay.total を求めるには手数料と税金を加算してください。泊単価だけでは宿泊客の支払総額になりません。
泊ごとの計算は、base_rate から stay_discount.amount を引き、channel_markup.amount、promotion、rounding_adjustment を加えると nightly_total になります。promotion は符号付きの減額です。rounding_adjustment は通貨で丸めた各要素を調整します。基本料金がない泊のステータスは missing です。不完全または失敗した見積もりで基本料金が分かっている泊のステータスは unpriced となり、nightly_total は null です。null をゼロに置き換えないでください。不明な清掃費、除外されたチャネルの税金・手数料、不明なコミッションは別々に示されます。stay.total_excludes と stay.warnings を確認してください。これらは Sixto に保存された数値であり、プロバイダーのリアルタイム見積もりや確認済みの空室状況ではありません。
稼働率
read=occupancy には reservations.view、property_id、from、to が必要です。unit は任意で、既定値は group_by=month です。ISO 形式の日付を使用し、to を含まない最大 366 泊の期間を指定します。各ユニットについて月ごとに一行が返り、nights_booked、nights_available、occupancy_pct、理由別のブロック泊数（オーナー滞在を含む）、pre_opening_nights が示されます。月別値と合計値は全ユニットを合算します。利用可能泊数からブロックされた泊とユニットの開業前の泊を除外し、occupancy_pct は nights_booked を nights_available で割った値です。不明な泊数は報告上の収容能力に含まれますが、予約可能と確認された在庫ではありません。施設全体の結果が大きい場合は 413 read_too_large が返るため、単一ユニットか短い期間を指定してください。
応答とエラー
成功時: {read, rows, result}。無効なクエリパラメーターには、error と details（parameters、required、one_of、example）を含む 422 が返ります。不明なパラメーターは拒否されます。存在しない、またはアクセスできないレコードは 404、権限不足は 403 です。実行が不明、期限切れ、キャンセル済み、または回答済みなら 404 run_not_live が返ります。サイズ制限には 413、頻度・読み取り制限には 429 を使用します。実行が許可する情報だけを取得し、アクセス範囲を広げて再試行しないでください。
完了と制限
回答前に読み取りを行ってください。実行が終了するか期限に達すると、読み取りアクセスは停止します。completion_expires_at と返されたエラーに従い、トークンが引き続き有効だと推測しないでください。同じ bearer ヘッダーと User-Agent を使い、complete_url に POST {answer, proposals} を送信します。提案を送信しても、それらは実行されません。同じ受理済み回答の再送信は冪等です。異なる回答には 409 result_conflict が返ります。