Skip to content

Changelog

2026-09-29: ordered on /v1/index levels, system alias

Section titled “2026-09-29: ordered on /v1/index levels, system alias”
  • GET /v1/index levels can carry ordered: true, when the guide itself ranks the level’s seeds, best first, in list order. seeds is then the author’s ranking. Additive within schema 1. See Seeds the guide ranks.
  • System alias is filled in, as an array of the other names the author uses for the system, verbatim. Before, no system carried one. The item menu sends null when there is none; a guide response omits it. See Reading a guide response.
  • topic is filled in on the system blocks of /items, /seeds and /patterns, where it used to be null. ?topic= on /v1/items/{def}/{paint} is checked against the published topics; an unknown topic is a 400. See Topics group, they don’t merge.
  • side on the same system blocks: playside, backside or both where the guide says so, else null.
  • GET /v1/index: every grade in one compact gzip response, grouped by system and level, with the topics listed once. See Every grade in one index.
  • dataset_version also covers the code that derives responses. A fix to a derived field (places, counts, aliases, response content) now changes it, and your ETag with it. A docs, formatting or infrastructure deploy still leaves it unchanged. See dataset_version.
  • A 304 Not Modified has no body. It used to carry {}; reuse your cached copy. See Caching & conditional requests.
  • CORS headers on every response. Access-Control-Allow-Origin: * and Access-Control-Expose-Headers: ETag, Retry-After are sent with or without an Origin header, and responses no longer vary on Origin. See Access & rate limits.

https://truefloat.app/api/v1: items, guides, seeds, patterns, resolve, meta and the bulk /dump endpoint. See Introduction and the API reference.