一个小技巧：修改swagger源码让postman更好用

本文假设你知道swagger，并且会用go:generate swagger generate spec -o swagger.json生成json。

首先生成的swagger.json是可以直接导入到postman的，其中的example会导入到postman的example。

// SignInParameter
// swagger:parameters SignIn
type SignInParameter struct {
	// required: true
	// in: body
	Data struct {
		// example: admin
		Email string `json:"email"`
		// example: admin
		Password string `json:"password"`
	} `json:"data"`
}

这样example就导入到postman的example里，在postman使用时需要把example的值复制到对应的请求体或者参数中。而有时候希望导入到postman的request可以直接send而不是再挨个设置一遍请求体或请求参数，这个时候可以用default。

// SignInParameter
// swagger:parameters SignIn
type SignInParameter struct {
	// required: true
	// in: body
	Data struct {
		// default: admin
		Email string `json:"email"`
		// default: admin
		Password string `json:"password"`
	} `json:"data"`
}