API — Testing Premium

A hands-on guide to setting up Postman and sending your first request against the Mokito API.

Testing with Postman

Postman is a free desktop application for sending and inspecting HTTP requests. It is the easiest way to explore the Mokito API before integrating it into your own code.

Download Postman: https://www.postman.com/downloads/ — available for Windows, macOS, and Linux. A web app is also available at go.postman.co.

Setting Up Postman

1. Install Postman

Download and install the desktop app from the link above. Postman is free for individual use.

2. Create an environment

Environments let you store variables (like your API token) so you don't have to paste it into every request. Create one for Mokito:

Click the Environments tab in the left sidebar.
Click + to create a new environment.
Name it Mokito API.
Add the following variables:

Variable	Initial Value	Current Value
`baseUrl`	`https://mokito.bippymiester.dev/api/v1`	`https://mokito.bippymiester.dev/api/v1`
`token`	`mok_yourTokenHere`	`mok_yourActualToken`

Set token's Current Value to your real API token (the one shown in your guild's Steam Links page). Save the environment, then select it from the environment dropdown in the top-right corner.

Never commit your token to a shared Postman workspace. If you're using a team workspace, store the token in your Postman Vault (local-only secrets) instead of an environment variable. In a personal workspace, the environment variable is fine.

3. Set up authentication

Postman supports Bearer auth natively. For each request you create, configure the auth tab:

Open the request and click the Authorization tab.
Set the type to Bearer Token.
In the Token field, type {{$token}} — Postman will substitute the variable from your environment.

Alternatively, add the header manually on the Headers tab:

Key	Value
`Authorization`	`Bearer {{$token}}`
`Accept`	`application/json`

Your First Request

Once your environment and auth are set up, any Mokito API endpoint can be tested the same way:

Click + New → HTTP Request.
Set the method (most Mokito endpoints are GET).
Enter the URL using your baseUrl variable: {{$baseUrl}}/<resource>/<endpoint>.
Go to the Authorization tab → type Bearer Token → token: {{$token}}.
Click Send.

For endpoint-specific walkthroughs — the exact URLs, query parameters, and expected response bodies — see the Testing page inside each resource's subcategory in the left sidebar (for example, Steam Links → Testing).

Save requests to a collection

Click Save on each request and add them to a collection called Mokito API. This keeps your requests organized and lets you re-run them with one click. You can also export the collection as JSON to share with your team.

Watch the rate limit in Postman. If you click Send more than 100 times in a minute, your token will be banned for 15–30 minutes. Check the X-RateLimit-Remaining response header to monitor your budget.

Postman Reference

For deeper Postman usage (collections, environments, variables, test scripts), see the official Postman documentation: