tsaikd/go-raml-mocker

go-raml-mocker https://travis-ci.org/tsaikd/go-raml-mocker.svg?branch=master](https://travis-ci.org/tsaikd/go-raml-mocker) https://goreportcard.com/badge/github.com/tsaikd/go-raml-mocker](https://goreportcard.com/report/github.com/tsaikd/go-raml-mocker)

镜像概述

本镜像为基于Go语言实现的RAML 1.0 Web Mock服务器，可根据RAML文件快速生成模拟API接口，支持实时重新加载路由配置，适用于前端开发、测试环境搭建等场景。

核心功能

• 从RAML文件实时重新加载Mock服务器路由，无需重启服务
• 支持RAML 1.0规范，兼容常见API定义格式

使用场景

1. 前端开发过程中，后端API尚未就绪时，快速搭建模拟接口以推进开发进度
2. 测试环境中，模拟不同API响应结果（如成功、失败、异常等），验证系统兼容性
3. API文档验证：通过RAML文件生成模拟服务，确保文档与实际接口行为一致

配置说明

使用Docker镜像部署

启动Mock服务器

bash
docker run \
	-p 4000:4000 \
	-v "${PWD}/example/organisation-api.raml:/raml/organisation-api.raml" \
	tsaikd/go-raml-mocker:1.0 \
	go-raml-mocker -f /raml/organisation-api.raml --port 4000

测试模拟接口

bash
# 获取组织数据
curl http://localhost:4000/organisation

# 提交组织数据
curl http://localhost:4000/organisation \
	-XPOST \
	--header "UserID: SWED-123" \
	--header "Content-Type: application/json" \
	-d '{"name":"Bob"}'

使用预编译二进制（Linux x86_64）

下载二进制文件

bash
curl 'https://github.com/tsaikd/go-raml-mocker/releases/download/1.0.2/go-raml-mocker-Linux-x86_64' -SLo go-raml-mocker && chmod +x go-raml-mocker

启动Mock服务器

bash
go-raml-mocker -f example/organisation-api.raml --port 4000

从源码编译使用

安装源码

bash
go get -u -v "github.com/tsaikd/go-raml-mocker"

查看所有配置参数

bash
go-raml-mocker -h