API内でページングのインデックスをゼロにする必要がありますか？

Question

ページングのパラメータを使用してRest APIを実装する場合、ページングのインデックスはゼロまたは1から開始する必要があります。パラメータはPageおよびPageSizeになります。私にとって

我々はページ

Answer 1

について話しているので、それには標準がありません、1から開始することは理にかなって。周りを見てみましょう：さまざまなアプローチを使用して数十万のAPIがあります。

私はページネーションのために、次のいずれかの方法を使用して知っているのAPIのほとんどは：

• offsetとlimitまたは
• pageと

どちらsizeは0または1をインデックス化することができます。どちらが良いですか？それはあなた次第です。

あなたのニーズに合ったものを選んで、を正しく文書化してください。。

---

さらに、ページ間のナビゲーションを容易にするために、応答ペイロードにいくつかのリンクを提供することができます。

は、たとえば、あなたがそう2ページからデータを読んでいる、前のページ（1）のために、次のページ（3ページ）のリンクを提供し考えてみましょう：

{ 
    "data": [ 
     ... 
    ], 
    "paging": { 
     "previous": "http://api.example.com/foo?page=1&size=10", 
     "next": "http://api.example.com/foo?page=3&size=10" 
    } 
} 

と覚えて、常にあなたはあなたが使用したいと思います。