# Sayfalama

Liste endpoint'leri tek ve öngörülebilir bir şekli takip eder: `data`
payload'ı `{items: [...], total, limit, offset}` olan sarmalanmış bir
zarf (bazı endpoint'ler `items`'ı `accounts`, `notifications` vs.
olarak adlandırır, ancak alanlar daima mevcuttur).

### Query parametreleri

| Parametre | Tip | Varsayılan | Aralık | Notlar |
|-----------|-----|------------|--------|--------|
| `limit` | integer | 50 | 1–1000 | Kontrolsüz taramaları önlemek için sıkı agent-tarafı üst sınırı. |
| `offset` | integer | 0 | ≥ 0 | Sıfır indeksli; sayfalama için `limit` ile birleştirin. |
| `sort` | string | endpoint'e özel | endpoint'e özel | Sunucuda typed enum (regex doğrulamalı). |
| `order` | string | `asc` | `asc`, `desc` | |

### Yanıt şekli

```json
{
  "status": "success",
  "data": {
    "items":   [ /* item nesneleri */ ],
    "total":   1245,
    "limit":   50,
    "offset":  0
  }
}
```

Tutarlı crawl semantiği gerektiren partner entegrasyonları için
`len(items) < limit` olana kadar `offset += limit` ile ileri sayfalayın.
WHost şu anda cursor tabanlı sayfalama sunmaz; gerekli olursa
`/api/v2/` altında eklenecektir.

---