Skip to content
Bazoodle API

curl quickstart

This guide gets you from nothing to a working call in about two minutes, using only curl, a tool that comes with Windows 10 and later, macOS and Linux. No account and no key.

1. Check the service is up

Section titled “1. Check the service is up”
Terminal window
curl -s "https://bazoodle.com/api/v1/healthz"

You should see ok. If you do not, try Status from another network.

2. List some games

Section titled “2. List some games”
Terminal window
curl -s "https://bazoodle.com/api/v1/catalog/browse?sort=new&limit=3"

The answer is one line of JSON. Add | python -m json.tool (if you have Python) to make it readable. The games list holds game cards.

3. Look at one game

Section titled “3. Look at one game”

Take an id from the list and read its page:

Terminal window
curl -s "https://bazoodle.com/api/v1/catalog/games/coins"

The response is a game page with the description, how to play and similar games.

Section titled “4. Search”
Terminal window
curl -s "https://bazoodle.com/api/v1/catalog/search?q=coin"

5. See the headers

Section titled “5. See the headers”

-i prints the headers before the body. This is where you find the cache time and, if you ever need it, Retry-After:

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

6. Make a wrong request on purpose

Section titled “6. Make a wrong request on purpose”
curl -s -i "https://bazoodle.com/api/v1/catalog/browse?sort=best"

The status is 400 and the body is {"error":{"code":"bad_request","message":"sort must be popular, new or top"}}. See Errors.

Next steps

Section titled “Next steps”