澶у濂斤紝鎴戞槸涔︽睙銆傚幓骞村勾涓啓浜嗕竴绡囧叧浜庡浣曟洿濂界殑绠＄悊Api鎺ュ彛鐨勬枃绔犮€傛渶杩戞湁鏈嬪弸闂垜锛屾垜浠兘鏄熀浜嶴wagger鏂囨。锛岀劧鍚庡湪swagger鏂囨。涓€滆鍙栤€濆悇涓井鏈嶅姟鍖呭惈鐨凜RUD锛堝鍒犳敼鏌ワ級绛堿PI锛岀劧鍚庘€滄墜鍔ㄢ€濇媺鍙栧嚭鍚勭鏈嶅姟鏂囦欢銆傝揪鍒板皝瑁呮晥鏋溿€備絾鏄繖鏍蜂細鏆撮湶涓€浜涢棶棰橈紝濡備笅馃憞濡傛灉鎺ュ彛鍙戠敓鍙樺寲锛屾瘮濡備粠v1杩佺Щ鍒皏2锛岄渶瑕佽繘琛屽ぇ閲忕殑鏀归€犮€傛垜姣忓鍔犱竴涓」鐩紝閮介渶瑕佸皝瑁呬竴濂楁湇鍔°€傞噸澶嶈疆瀛愭槸涓€绉嶅揩涔愶紵鍥㈤槦鍔犲叆鏂版垚鍛橈紝閲嶅缂栧啓鎺ュ彛灏佽绛夛紝鏈変粈涔堝姙娉曞彲浠ヨВ鍐充互涓婇棶棰橈紵鏈夋柟娉曘€傛湰璐ㄤ笂鏄€氳繃绋嬪簭鑷姩鍖栫敓鎴愬悇绉嶆湇鍔℃枃浠讹紝瑙ｆ斁浣犵殑鍙屾墜銆傛€庝箞鍋氾紵鎴戜滑鍙互瑙ｆ瀽swagger鎺ュ彛鏂囨。鐨勭粨鏋?.浠€涔堟槸Swagger/OpenAPI锛熷湪璇磋В鏋愭枃妗ｄ箣鍓嶏紝鎴戜滑棣栧厛闇€瑕佷簡瑙ｄ竴涓婳penAPI馃憞OpenAPI瑙勮寖锛屽張绉癘AS锛屾槸涓€绉岮PI鏂囨。鏍囧噯銆傞€氳繃OpenAPI瑙勮寖瀹氫箟鎮ㄧ殑API锛屾偍鍙互浣跨敤鏂囨。鐢熸垚宸ュ叿鏉ユ樉绀烘偍鐨凙PI銆傛偍鐢氳嚦鍙互浣跨敤浠ｇ爜鐢熸垚宸ュ叿鑷姩鐢熸垚鍚勭缂栫▼璇█鐨勬湇鍔″櫒绔拰瀹㈡埛绔唬鐮併€傪煈ч樋涔愶細openAPI鍜宻wagger鏈変粈涔堝叧绯伙紵OpenAPI濮嬩簬Swagger瑙勮寖锛岃瑙勮寖浜?015骞存崘璧犵粰Linux鍩洪噾浼氬苟鏇村悕涓篛penAPI锛屽苟灏嗘渶鏂拌鑼冨畾涔変负OpenAPI3.0銆傛湰璐ㄤ笂锛屼綘鍙互鐞嗚В涓哄墠鑰呮槸瑙勮寖锛屽悗鑰呮槸瀹炵幇瑙勮寖鐨勫伐鍏枫€傪煈嘜penAPI=SpecificationSwagger=瀹炵幇瑙勮寖鐨勫伐鍏佛煈﹂樋涔愶細閭ｄ箞閫氳繃OpenAPI瑙勮寖瀹炵幇鐨勫璞℃槸浠€涔堟牱鐨勫憿锛熷叿浣撴潵璇达紝涓昏鍖呮嫭浠ヤ笅瀛楁淇℃伅锛堟寚鐨勬槸OpenAPI3.0锛夈€傚鏋滄兂瀹炴椂棰勮OpenAPI鍦ㄧ嚎缂栬緫鐨勬晥鏋滐紝鍙互灏濊瘯浣跨敤SwaggerEditor鏈変粈涔堝尯鍒憿锛烵AS2鏄疭wagger2鐨勭缉鍐欍€備笂闈㈣浜嗭紝鑷粠Swagger瑙勮寖鎹愯禒缁檒inux涔嬪悗锛孲wagger瑙勮寖灏辨敼鍚嶄负OpenAPI瑙勮寖锛屼篃灏辨槸鎴戜滑璇寸殑OAS3銆備笅鍥炬槸涓よ€呯殑鍖哄埆馃憞鎺ㄨ崘闃呰锛欰pifox-OpenAPISpecification锛堜腑鏂囩増锛?.濡備綍瑙ｆ瀽Swagger/OpenAPI锛熸暣鐞嗗ソOpenAPI瑙勮寖缁撴瀯涔嬪悗锛屾帴涓嬫潵鎴戜滑闇€瑕侀€氳繃瑙ｆ瀽OpenApi鏂囨。缁撴瀯鏉ョ敓鎴愭垜浠殑鏈嶅姟鏂囦欢銆傜洰鍓嶅湪绀惧尯鎵惧埌涓や釜瑙ｅ喅鏂规馃憞2.1@umijs/plugin-openapi鎻掍欢umijs灏佽浜嗕竴涓猳penapi鎻掍欢锛岄€氳繃杈撳叆涓€涓猳penapi瑙勮寖鏂囦欢鍗冲彲瀹屾垚鑷姩鍒涘缓鏈嶅姟銆傛垜浠彲浠ラ€氳繃swagger-ui鎺ュ彛鑾峰彇杩欎釜瑙勮寖鏂囦欢鐒跺悗灏唖waggerurl澶嶅埗鍒皁penapi閰嶇疆涓紙schemaPath鍙傛暟锛夛紝鍙互鍙傝€冧笅鍥攫煈囩劧鍚庢墽琛屽懡浠よ鑷姩鐢熸垚濡備笅鐩綍缁撴瀯鏈嶅姟浜庢浠ュ疇鐗╁簵鐨凞EMOAPI鏂囨。涓轰緥銆備笅闈㈢湅鐪嬬敓鎴愮殑鎺ュ彛鏄浣曞皝瑁呯殑銆傚悓鏃舵垜浠繕浼氬湪serves涓敓鎴恡ypings.d.ts鏂囦欢锛岄噷闈㈠寘鍚簡openapi涓殑瀹氫箟銆傝繖涓伐鍏风洰鍓嶇殑缂虹偣鏄粦瀹氬緢閲嶃€倁mi瀵逛腑鏂囨敮鎸佷笉鍙嬪ソ銆傚鏋滆寰椾笉閫傚悎鍋氬唴閮ㄦ妧鏈爤锛屽彲浠ュ弬鑰冨伐鍏风殑瀹炵幇鎬濊矾锛岀劧鍚庡湪瀹冪殑鍩虹涓婇€犺嚜宸辩殑杞瓙銆?.2鏈湴鍖栧伐鍏风敓鎴怬penApi绀惧尯寮€婧愪簡OpenApiGenerator銆傛垜浠彲浠ヤ娇鐢∣penAPIGenerator鎻愪緵OpenAPI瑙勮寖锛堜笂闈㈡彁鍒扮殑OAS2鍜孫AS3锛夋潵鑷姩鐢熸垚API瀹㈡埛绔簱銆佹枃妗ｅ拰閰嶇疆銆傛瘮濡傛垜浠殑鍓嶇渚濊禆axios浣滀负璇锋眰搴擄紝閭ｄ箞鎴戜滑鍙互閫氳繃鎸囧畾绫诲瀷鏉ョ敓鎴恡s+axios璇锋眰鐩稿叧鐨勪唬鐮併€傚叿浣撲娇鐢ㄦ柟娉曞彲浠ュ弬鑰凁煍梘ithub-openapi-generator濡傛灉浣犳槸鍓嶇锛屼笉鐔熸倝java锛岀洿鎺ヤ娇鐢ㄤ細鍙楀埌鎶€鏈爤鐨勯檺鍒讹紝鍥犱负瀹冩彁渚涗簡JAR鍖呫€傝櫧鐒朵篃鎻愪緵浜哻li宸ュ叿锛屼絾鏄彧鏀寔yml鏍煎紡瑙ｆ瀽銆傞偅涔堟湁娌℃湁鏇村彲缂栬緫鐨勬柟寮忥紝鍙互涓嶄緷璧栫幆澧冧娇鐢ㄥ憿锛熻繖閲屾湁涓€涓伐鍏蜂緵澶у鐩存帴浣跨敤锛欰pifoxApifox涓嶄粎鏀寔mock鍑芥暟鍜屾帴鍙ｈ皟璇曪紝鎴戝彂鐜拌繕鏈変唬鐮佺敓鎴愬姛鑳姐€備唬鐮佺敓鎴愬紩鎿庝娇鐢ㄦ垜浠彁鍒扮殑openapi-generator锛屽彲浠ユ牴鎹帴鍙?妯″瀷鏉ュ畾涔夈€傝嚜鍔ㄧ敓鎴愬悇绉嶈瑷€/妗嗘灦锛堝TypeScript銆丣ava銆丟o銆丼wift绛?30绉嶈瑷€鍜屾鏋讹級鐨勪笟鍔′唬鐮侊紝濡傛帴鍙ｈ姹備唬鐮併€傛瘮濡傛垜浠篃鍙互閫夋嫨鎴戜滑瀵煎嚭鐨勪唬鐮佷腑鍖呭惈鐨勫唴瀹癸紝姣斿鍙寘鍚帴鍙ｄ唬鐮佹垨鑰呭彧鍖呭惈妯″瀷绛夈€?.鏈€鍚庡鏋滃ぇ瀹舵湁鏇村ソ鐨勫疄鐜版柟娉曪紝涔熷彲浠ュ湪璇勮涓暀瑷€涓撳尯锛屾垨鑰呭姞鎴戝井淇★紝鎴戜滑涓€璧峰枬鑼娥煃佃璁?/p>
