Apidog

All-in-one Collaborative API Development Platform

API Design

API Documentation

API Debugging

API Mocking

API Automated Testing

Mock REQUEST Bodies to Accelerate API Debugging

This article discusses the benefits of using a tool that automatically generates request bodies for API debugging. It highlights the importance of having good tools to maintain code quality and how this tool can help construct a correct request JSON for debugging.

Ismail Kamil

Ismail Kamil

Updated on November 29, 2024

When developing APIs, debugging is always a boring problem.

Postman can help send requests, but when the API body is complicated, constructing a JSON body would be difficult. Junit also works, but all requests must be constructed yourself in testing classes.

Complex bodies make many backends abandon unit tests and output an untested API to frontend developers and QA engineers.

The above case demonstrates that the code quality declines without a good tool. And now, there is a useful tool named Apidog that can generate the request body automatically when debugging. The tool can construct a correct request JSON itself.

How to Mock Request Bodies

This approach works for API-first teams. APIs are designed before developing, so while debugging, you have an API specification.

1. Import the API specifications into Apidog. (How to Mock An API? )
2. Open an API, and make sure the request has a JSON/XML body specification.

Image Description

3. Switch to the "Run" tab, and click the "Generate Automatically" button. You've got a mock JSON according to the request specification!

Image description

And now click "send" to send the request like what you did in Postman, but more efficiently. Most features in Postman are also supported in Apidog. Our team has used Apidog to debug APIs instead of Postman for weeks.

What's More

Notice the mock data. It was generated automatically according to the field name. A field named "city" are mocked with a city name, a field named photo URL is mocked with a photo URL, and all mock data follows JSON schema specified in the API. Just like the previous article: How to mock complex JSON.

And that's not the end. Hover on the arrow beside "Generate Automatically", and you'll see three menu items.

Mock Menu Items

"Default value first" means the mock JSON would be filled by the default value specified in each field of the API first. "Example value first" means the mock JSON would be loaded by the example request JSON first. But what is "Refresh when sending request"?

It's just the literal meaning. Each time the request is sent, the body is generated again.

How to Customize Request Bodies

Until now, everything looks great. But what if some of my fields are not expected to change? How can I make some fields fixed and some mocked?

Click the "Dynamic Value" button, and you'll find a new world.

Image description

All Faker.js syntaxes are supported, and you can select any of them directly. You can even select a function to mutate the mock value like md5, substrate or base64, etc.
Then it will be inserted into the request body, just like this.

Request Bodies

You can decide which field is fixed and which is mocked by Faker.js. When sent, all faker fields will change to the actual data below.

Set up Params

That's it. And it changes each time sending. Apidog is a great tool that makes our team build APIs faster.

Revolutionize Your Workflow: Mastering the Cursor AI Agents FeatureTutorials

Revolutionize Your Workflow: Mastering the Cursor AI Agents Feature

Discover how the Cursor AI Agents feature can revolutionize your coding workflow in this comprehensive tutorial. Learn step-by-step how to set up, use, and optimize AI-powered code generation, multi-file edits, terminal command execution, and more.

Ashley Innocent

February 12, 2025

Validate API Response Effortlessly with ApidogTutorials

Validate API Response Effortlessly with Apidog

Developers can save time and reduce errors with Apidog’s automatic API response validation. By validating response content, schema, and additional properties, teams can ensure accurate, up-to-date API specifications without manual intervention.

Oliver Kingsley

February 12, 2025

Creating Multilingual API Docs to Expand GloballyTutorials

Creating Multilingual API Docs to Expand Globally

Want to expand your API’s reach globally? Learn how to use Apidog’s API versioning feature to create multilingual documentation. This step-by-step guide will help you deliver API content in different languages, increasing accessibility and user satisfaction.

Oliver Kingsley

February 11, 2025