Empty vs missing
| request | answer |
|---|---|
unknown def_index, or a paint_index the item doesn’t have |
404 not_found |
| known item, seed no guide grades | 200, verdicts: [], every covering system listed in not_listed |
| known item with no guide at all | 200, guides: [] or seeds: {} |
unknown steam_id or system |
404 not_found |
Missing identity is a 404; missing opinion is a 200 with an empty
list. not_listed names the systems that cover the item but don’t grade
the seed, so “not ranked by this guide” is distinct from “no such guide”.
curl https://truefloat.app/api/v1/items/7/44/seeds/1{ "dataset_version": "e9c25a6", "data": { "item": { "def_index": 7, "paint_index": 44, "slug": "ak47-case-hardened" }, "seed": 1, "verdicts": [], "not_listed": [ {"steam_id": "2941982575", "system": "ak47-blue-gem"}, {"steam_id": "3313951742", "system": "ak47-gold-gem"} ] }}curl https://truefloat.app/api/v1/items/7/45{ "dataset_version": "e9c25a6", "error": {"code": "not_found", "message": "no item def 7 paint 45"}}