Paginarea

Cursor semnat, 20 pe pagină, pe rând.

Toate listele merg doar pagină cu pagină: cel mult 20 de rezultate, iar pentru restul trimiți cursorul primit înapoi.

curl "https://api.ajungem.ro/v1/listings?limit=20"
# { "data": [...], "hasMore": true, "nextCursor": "eyJ…" }

curl "https://api.ajungem.ro/v1/listings?cursor=eyJ…"
  • Cursorul e legat de filtre și de titular — cheia ta, sau adresa, dacă nu trimiți cheie. Un cursor luat cu alte filtre sau de altcineva întoarce 409, cu mesajul că lista s-a schimbat și trebuie luată de la capăt.
  • Expiră în 15 minute.
  • Trebuie să treacă o clipă între două cereri cu cursor (peste 400 ms) — un program care cere pagina imediat după primeşte 429.
  • Nu există offset: nu poți sări direct la pagina 50.

Nu e o limitare tehnică ocolibilă — e gândită să oprească exact colectarea în masă. Pentru integrări care au nevoie de tot ce se publică pe o rută, urmărește webhook-urile (planificate, lotul 3), nu re-parcurgerea listei publice.