Apidog

All-in-one Collaborative API Development Platform

API Design

API Documentation

API Debugging

API Mock

API Automated Testing

Sign up for free

Step-by-Step Guide to Mastering Mock APIs with Apidog

Start for free
Contents
Home / Applied skills / Step-by-Step Guide to Mastering Mock APIs with Apidog

Step-by-Step Guide to Mastering Mock APIs with Apidog

API Mock is a technique that replaces the real API interface with simulated data. With Apidog, it only takes 3 steps to set up a Mock API.

API Mocking is a technique that uses simulated data in place of real API responses. During development, front-end developers often rely on APIs that might still be under construction. Mock APIs allow them to continue development without waiting for the back-end APIs to be completed. Apidog makes this process simple and efficient, allowing you to create Mock APIs in just three steps.

button

Step 1: Create a New API Project

Apidog organizes API endpoints into projects. Each endpoint must be part of a project, and you can create multiple endpoints within one project. To begin, click the "New Project" button on the Apidog homepage to create your project.

Creating a new API project at Apidog

Step 2. Create a New API Endpoint

For example, to create an API for user details:

  • Request method: GET
  • URL: api/user/{id} (where {id} is the user ID parameter)
  • Response type: JSON.
  • Response content:
{
id: number, // user id
name: string, // username
gender: 1 | 2, // gender: 1 for male, 2 for female
phone: string, // phone number
avatar: string, // avatar image address
}

From the project homepage, click the "+" button on the left to add a new API endpoint.

Creating a new API endpoint at Apidog

Input the required details and save it.

Fill in required info to create a new API endpoint

Once the API is created, Apidog automatically generates a mock API based on your defined API specifications. On the endpoint documentation section, find the Mock section, you can see a list of URLs of mock APIs.

Getting the URL of the Mock API at Apidog

Click on "Request" to send the API request to see the mock response in action.

Sending mock API request to see how it works

Step 3. Customize API Mock Matching Rules

Apidog takes API mocking a step further by providing built-in matching rules for fields like names, phone numbers, and image URLs, automatically returning relevant data types.

You can also customize Mock rules in Project Settings > Feature Settings > Mock Settings.

Customizing API mock matching rules at Apidog

You can also customize specific rules for individual fields by clicking Mock next to them.

Customize mocking rules for individual fields

Apidog’s matching rules include:

  • Wildcards: For example, *name matches "username" or "name."
  • Regular expressions: Define complex patterns.
  • Exact match: Specific field values.

These rules extend Mock.js syntax and support features like generating random integers, strings, phone numbers, URLs, and more.

Flexible API Mock Scenarios

Need more flexibility? Apidog supports advanced scenarios like returning custom responses based on request parameters. For instance, you can return normal user info when the ID is 1 and trigger an error when the ID is 2. Check out Apidog’s Advanced Mock documentation for details.

Conclusion

Apidog simplifies the process of creating and managing Mock APIs, while also offering API documentation, debugging, and automation testing features. Try Apidog today to experience a seamless API development workflow!

button