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.