Paginação por cursor

GET /v1/appointments?limit=25
GET /v1/appointments?limit=25&cursor={nextCursor}

{
  "data": [...],
  "pagination": {
    "hasMore": true,
    "nextCursor": "eyJjcmVhdGVkQXQiOiIuLi4ifQ"
  }
}

• Trate nextCursor como opaco: não decodifique, edite ou construa cursores no cliente.
• Quando hasMore=false, nextCursor é null e a paginação terminou.
• Use o mesmo conjunto de filtros em todas as páginas da mesma varredura.
• INVALID_CURSOR indica cursor corrompido/incompatível; reinicie sem cursor.