Categories, filters and feedback tags

Two small endpoints return fixed lists of choices. Read each once and cache it: they change rarely.

Categories and filters

GET /catalog/categories lists the categories (tags) a game can have, and the extra filters you can use with Browse.

curl -s "https://bazoodle.com/api/v1/catalog/categories"

There are no parameters.

{
  "tags": [
    {"id": "party", "label": "Party"},
    {"id": "obby", "label": "Obby"},
    {"id": "shooter", "label": "Shooter"},
    {"id": "racing", "label": "Racing"},
    {"id": "sandbox", "label": "Sandbox"},
    {"id": "puzzle", "label": "Puzzle"},
    {"id": "sports", "label": "Sports"},
    {"id": "building", "label": "Building"}
  ],
  "filters": [
    {"id": "two_players", "label": "Two players"},
    {"id": "solo", "label": "Plays solo"}
  ],
  "max_tags_per_game": 3
}

Field	Type	Meaning
tags	list of {id, label}	The eight categories. Use id as the tag value in Browse and in cats for Home. Show label to people. The same ids are in each card’s tags list.
filters	list of {id, label}	Extra ways to narrow a list. Use id as the filter value in Browse.
max_tags_per_game	number	A creator can give a game at most this many tags.

• Only Bazoodle adds categories; creators choose from the list. The id values are lower case and stable; label text can be reworded, so do not use it as a key.
• two_players shows games that two players can play; solo shows games made for one player. Both work on the players numbers on every card.
• Build your menu from this response instead of copying the table, so it follows changes. An unknown tag or filter sent to Browse answers 400.
• Cached for 5 minutes.

Feedback tags

GET /catalog/feedback-tags lists the short reasons a player can pick when they give a game a thumbs-up or thumbs-down. Players pick them when they rate a game inside Bazoodle. The public API only lets you read the list.

curl -s "https://bazoodle.com/api/v1/catalog/feedback-tags"

{
  "up": [
    {"id": "fun_with_friends", "label": "Fun with friends"},
    {"id": "great_solo", "label": "Great to play solo"},
    {"id": "looks_great", "label": "Looks great"},
    {"id": "want_more_levels", "label": "Want more levels"},
    {"id": "easy_to_learn", "label": "Easy to learn"},
    {"id": "funny", "label": "Funny"}
  ],
  "down": [
    {"id": "too_hard", "label": "Too hard"},
    {"id": "laggy", "label": "Laggy"},
    {"id": "confusing", "label": "Confusing"},
    {"id": "too_short", "label": "Too short"},
    {"id": "hard_to_find_match", "label": "Hard to find a match"},
    {"id": "buggy", "label": "Buggy"}
  ]
}

Field	Type	Meaning
up	list of {id, label}	Six reasons for a thumbs-up
down	list of {id, label}	Six reasons for a thumbs-down

Feedback is a fixed list with no free text, so no player can write a message to another through it. Cached for 5 minutes.