Pagination

Lists page with limit and an opaque cursor. Follow nextCursor until it's null.

Response 200

{
  "data": [{ "id": "0b6f3c1e-7a42-4c55-9b1d-2f6e8a1c4d90" }],
  "total": 134,
  "nextCursor": "eyJvIjoyMH0"
}

Field
`data`	This page.
`total`	How many in the whole list.
`nextCursor`	Pass it as `cursor` for the next page. Null on the last.

All pages

JavaScript

async function all(path) {
  const items = [];
  let cursor = null;
  do {
    const url = new URL(`https://taseli.co.il/api/v1${path}`);
    url.searchParams.set("limit", "100");
    if (cursor) url.searchParams.set("cursor", cursor);
    const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.TASELI_KEY}` } });
    if (!res.ok) throw new Error((await res.json()).error.code);
    const page = await res.json();
    items.push(...page.data);
    cursor = page.nextCursor;
  } while (cursor);
  return items;
}

const accounts = await all("/accounts");

What pages

Endpoint	Default `limit`	Max	Whole list
`GET /accounts`	50	100	Every account
`GET /proposals`	20	100	The latest 200
`GET /activity`	50	100	The latest 200

GET /creatives takes limit up to 100 and GET /competitors/ads up to 30, with no cursor: shown and of say how much came back; narrow with filters for the rest. GET /webhooks returns all of them (at most 5). by=campaign metrics return the 200 highest spenders. For metrics over 400 days, ask period by period.

Rules

Treat a cursor as opaque. Don't build one, and don't store one for later.
A cursor is a position, not a snapshot. If the list changes between pages, a row can repeat or be skipped. For status=waiting, which sorts by value, expect it.
A limit out of range or an unreadable cursor answers 400 invalid_parameter.