swagger-faker
Generate mock data and initiate a mock server automatically from Swagger or OpenAPI specifications, simplifying the development process by providing realistic API responses without needing a backend.
Author

Pingtouges
No License
Quick Info
Tools 1
Last Updated 2026-02-19
Actions
Tags
swaggerapisapipingtouges swaggerswagger fakerswagger openapi
Swagger Faker
Swagger Faker is a tool which can help you generate fake data from your swagger.json file, then it will start a mock server automatically with the generated fake data.
How to Use
- Install
npm i swagger-faker -g
- Init config file by command:
swagger-faker init
Then it will generate a config file swagger-faker.config.json in current path, update that config file:
{
"sourcePaths": ["./source/openapi.json"],
"outputFolder": "mock-server",
"timeout": 180000,
"port": 8081
}
- sourcePaths:
required, put your swagger/openapi file path here - outputFolder:
optional - timeout:
optional, -
port:
optional -
Generate fake data
swagger-faker gen
- Start the mock server
swagger-faker run
Examples
git clone https://github.com/reeli/swagger-faker-examples.git
cd swagger-faker-examples
npm install
npm start
Then you'll see:
- A
mock-serverfolder has been generated in your current path, and all mock data is setting inmock-server/datafolder, you can customize them if needed. - A mock server has been started in
http://localhost:8081, you can open your browser and visit one of the mock API byhttp://localhost:8081/api/v2/store/order/1(The mock data is setting in:mock-server/data/getOrderById.json)
