Housing Market API 連携ガイド

ページネーション

すべての一覧エンドポイントはカーソルを使用します。レスポンスには data、next_cursor、has_more が含まれます。

あるレスポンスの next_cursor を次のリクエストの cursor として渡し、has_more が false になったら終了してください。

総件数やページ番号はありません。これは意図的な設計です。この API は掲載情報を検索するためのものであり、データベースを複製するためのものではありません。

limit パラメーターでページサイズを設定します。デフォルトは 50 で、100 を超えることはできません。

カーソルは不透明な値です。解析したり、独自に組み立てたり、後で使うために保存したりしないでください。カーソルはお客様のキーと、それを生成したリクエストのフィルターに紐付いており、無効なカーソルは invalid_cursor で拒否されます。

一回の巡回の中では結果の順序は一定ですが、その順序に意味はありません。順序に依存しないでください。