鍦╣olang涓紝鍙互浣跨敤寮€婧愮殑宸ュ叿鍜屽簱鏉ヨ嚜鍔ㄧ敓鎴怉PI鎺ュ彛鐨勪唬鐮併€備互涓嬫槸涓€绉嶅父瑙佺殑鏂规硶锛?/p>

1. 浣跨敤Swagger/OpenAPI瑙勮寖瀹氫箟API鎺ュ彛鐨勭粨鏋勫拰瀹氫箟銆係wagger鏄竴绉峈ESTful API鏂囨。瑙勮寖锛屽彲浠ョ敤浜庢弿杩癆PI鐨勮姹傚拰鍝嶅簲缁撴瀯锛屼互鍙夾PI鐨勮矾寰勩€佸弬鏁扮瓑淇℃伅銆?/p>

2. 浣跨敤go-swagger宸ュ叿鐢熸垚浠ｇ爜銆俫o-swagger鏄竴涓敤浜庣敓鎴恎olang浠ｇ爜鐨勫懡浠よ宸ュ叿锛屽彲浠ユ牴鎹甋wagger瑙勮寖鐢熸垚瀵瑰簲鐨凙PI鎺ュ彛浠ｇ爜銆?/p>

• 棣栧厛锛屽湪椤圭洰涓畨瑁単o-swagger宸ュ叿锛?code>go get -u github.com/go-swagger/go-swagger/cmd/swagger

• 鐒跺悗锛屽湪椤圭洰鏍圭洰褰曚笅鍒涘缓涓€涓猻wagger.json鎴杝wagger.yaml鏂囦欢锛岀敤浜庡畾涔堿PI鐨勭粨鏋勫拰瀹氫箟銆?/p>

• 鎺ョ潃锛屽湪椤圭洰鏍圭洰褰曚笅杩愯浠ヤ笅鍛戒护鐢熸垚浠ｇ爜锛?code>swagger generate server -A <app-name> -f <path-to-swagger-file>

鍏朵腑锛?code><app-name>鏄綘鐨勫簲鐢ㄧ▼搴忓悕绉帮紝<path-to-swagger-file>鏄痵wagger.json鎴杝wagger.yaml鏂囦欢鐨勮矾寰勩€?/p>

• 杩愯瀹屾垚鍚庯紝go-swagger浼氭牴鎹甋wagger瑙勮寖鐢熸垚瀵瑰簲鐨凙PI鎺ュ彛浠ｇ爜锛屽苟灏嗕唬鐮佽緭鍑哄埌./cmd/<app-name>/restapi鐩綍涓嬨€?/li>

3. 鏍规嵁闇€瑕佷慨鏀圭敓鎴愮殑浠ｇ爜銆傜敓鎴愮殑浠ｇ爜鍙兘鍙槸涓€涓鏋讹紝浣犲彲鑳借繕闇€瑕佹牴鎹叿浣撶殑涓氬姟闇€姹傝繘琛屼竴浜涗慨鏀瑰拰瀹氬埗銆?/p>

4. 鏋勫缓鍜岃繍琛屽簲鐢ㄧ▼搴忋€傛牴鎹敓鎴愮殑浠ｇ爜锛屼綘鍙互浣跨敤鏍囧噯鐨刧o build鍜実o run鍛戒护鏉ユ瀯寤哄拰杩愯搴旂敤绋嬪簭銆?/p>

闇€瑕佹敞鎰忕殑鏄紝鑷姩鐢熸垚鐨凙PI鎺ュ彛浠ｇ爜鍙兘鍙槸涓€涓熀纭€妗嗘灦锛屽彲鑳借繕闇€瑕佽繘琛屼竴浜涢澶栫殑寮€鍙戝拰淇敼锛屼互婊¤冻鍏蜂綋鐨勪笟鍔￠渶姹傘€?/p>