API testing tutorial: from your first request to a check that catches bugs
Checkcraft is a desktop app for checking APIs and logs without code, with a free edition. Download, no sign-up →
API testing is not “did a response arrive” but “is it right, and what happened after it”. Here are five steps from the first request to a check that catches the bug on every run.
Step 1. Write the expectation before the request
Start from the requirement: which fields must come back and how they relate. For an order: total = subtotal − discount, status is one of NEW, PAID, SHIPPED, CANCELLED. The expectation comes from the requirements, not from the first server response, or the test will lock the bug in.
Step 2. Send the request and compare
Send it from curl, Postman or right from the practice API page.
# 1. Send a request
curl -s https://checkcraft.ru/practice-api/v1/orders/5001.json
# 2. What came back (excerpt)
"subtotal": 3170.00, "discount": 300.00, "total": 2970.00
# 3. What to check
status 200 ✓
total = subtotal − discount ✗ (3170 − 300 = 2870, the API says 2970)Step 3. Check more than the status
A 200 means the server understood the request, not that the result is right. Check types (a number, not a string), allowed values, extra fields (leaks), calculations, every array item and consistency between answers: the list and the card must agree.
Step 4. Look at what happened after the response
The most expensive bugs come after the response: the payment service never got the request, the log has an error, the database row is still NEW. Find the log records of the same request by traceId and check their fields; with database access, run a SELECT by the ID.
Search a log by traceId online →
Step 5. Save the check and hand it to an AI
A manual check is forgotten after the release. Save the rules so they run every time, by hand or in CI. Checkcraft does it without code: the response, the log by traceId and the database in one check. An AI drafts the checks from the requirement, either the built-in local one (Windows build) or your Claude Code and Cursor over MCP, and they run the same way every time. You make the call.
Practise
All ten typical bugs from this tutorial hide in the practice API. Find them and get into the hall of fame.
Repeat this on your own API
Checkcraft is a desktop app that saves API response checks without code and shows what did not match. Start with a sample, then use your own sanitized data. Free runs on Windows and Linux with no time limit.
Download FreeDownload and first runNo sign-up or email needed, the archive is ready in a couple of minutes. See the edition limits.
Start with the linked example and compare its result with your own test requirement.