予期せぬページネーション、繰り返し、競争。

Limit and offset pagination

リストでは、1 ～ 100 の制限とゼロからのオフセットが使用されます。 offset + data.length が pagination.total 未満である限り続行します。

GET /api/v1/offers?status=approved&marketplace=amazon&limit=50&offset=100

{
  "data": [ ... ],
  "pagination": { "limit": 50, "offset": 100, "total": 384 },
  "request_id": "req_01J..."
}

フィルターと検索

冪等性と安全な反復

GET、PATCH、DELETE は同じ意味で繰り返すことができます。 URL によるオファーや外部参照による受信など、文書化された自然キーを持つ作成物は、リソースを複製するのではなく、既存のリソースを返します。

サイズ、時間、制限