API talk:Continue

From mediawiki.org
Latest comment: 2 months ago by Vicarage in topic Needs a clear example

Needs clarification[edit]

It is not obvious at all that there can be many [prefix]continue properties in the response, like this:

"continue": {
  "clcontinue": "6729231|Given_name_appendices",
  "continue": "||",
  "plcontinue": "6720|0|atta",
}

Stumbled upon this with generators. There is no info on this in mw:API:Generators as well.

> This can be useful to avoid building a combined result set for thousands of pages when using a generator together with prop modules that may themselves need continuation.
I needed several readings and testing with my own code to understand what that means. So, apparently batchcomplete is effectively a shorthand for "there is no g[prefix]continue", correct? Too much fluff, too little specificity.

No clear examples of supplying the contuniation params back to the next request. Instead, there are examples of queries that need continuation. Probably this is because such examples would be unstable, but the examples don't need to be working; being tangible is enough.

In short, all of this requires additional thinking and sorting things out in your head; this is not an example of particularly clear docs. JWBTH (talk) 23:31, 9 September 2023 (UTC)Reply

Needs a clear example[edit]

Clear as mud. The documentation needs a clear example of continuation, a first call producing json, the jq command to extract the continuation string, and a second call using that string. Vicarage (talk) 21:02, 12 February 2024 (UTC)Reply