Stoplight StudioÊÇStoplightÓÃÒÔAPIÉè¼Æ¡¢½¨Ä£ºÍ¼¼ÊõÐÔ׫дµÄÏÂÒ»´ú³ÌÐòÔËÐУ¬StudioµÄ¹Ø¼ü×ÜÌåÄ¿±êÊǷḻ¶à²Ê¶ø²»ÊÇÌæ´úÄúÄ¿Ç°µÄ¹¤×÷ÄÚÈÝ£¬µ±ÔÚµ±µØÔË×÷ʱ£¬ËüÄܹ»³¹µ×ÍÑ»ú¹¤×÷£¬Îļþ¼ÐÃû³ÆºÍÎĵµ¶¼»áÄúµÄµç×Ó¼ÆËã»úÉÏ£¬ÈçͬÄú×î°®µÄIDEÒ»Ñù£¬µ±ÔÚµçÄÔä¯ÀÀÆ÷ÖÐÔË×÷ʱ£¬»¥ÁªÍøÔÉú̬µÄGitÊÊÓÃÄܹ»¸øÄã²»·ÑÁ¦ÆøµØ°²È«ÐÔºÏÀíµØÓ¦ÓÃÄãÄ¿Ç°µÄ¿â·¿¡£
¡¡¡¡È«·½Î»ÊÊÓÃOpenAPI v2ºÍv3
¡¡¡¡StudioµÄÈ«²¿×÷Óö¼³¹µ×ÊÊÓÃOpenAPI 2ºÍ3°æ±¾µÄ±ê×¼Îļþ¸ñʽ¡£Õâ´ú±í×ŶÔOpenAPI±ê×¼µÄ2¸ö°æ±¾¶¼ÊÇÓÐÏêϸµÄÈÏÖ¤¡¢·í´ÌºÍ½¨Ä£ÊÊÓá£
¡¡¡¡Studioϲ°®Swagger OpenAPI
¡¡¡¡Í¼ÐνçÃæµÄAPIÉè¼Æ
¡¡¡¡¸ù¾Ý±í¸ñµÄÉè¼Æ´ú±í×ÅÄã²»ÓÃÊÇÒ»¸öOpenAPIȨÍþר¼Ò¾Í¿ÉÒÔ¸Õ¿ªÊ¼¡£StudioÓÐÒ»¸ö "д"£¨±àÂ룩·½Ê½£¬¾ß±¸ÏêϸµÄOpenAPIÈ«×Ô¶¯½øÐÐ×÷Ó㬻¹ÓÐÒ»¸ö "¶Á "·½Ê½£¬ÓÃÒÔÊý¾Ý¿ÉÊÓ»¯HTTPʵ¼Ê²Ù×÷ºÍʵÌåÄ£ÐÍ¡£
¡¡¡¡OpenAPIµÄͼÐÍÉè¼Æ
¡¡¡¡ÒªÕÆÎÕ´óÁ¿ÓйØÔõÑùÔÚ²»×«Ð´Ò»ÐÐJSON»òYAMLµÄ×´¿öÏÂѸËÙÉè¼ÆºÍÔÐÎAPIµÄÐÅÏ¢£¬Çë¿´ÕâÀï¡£
¡¡¡¡JSON·½Ê½½¨Ä£
¡¡¡¡Studio²»Ö»ÊǶÔÓÚAPI£¬ÄãÒªÄܹ»½¨Á¢ºÍ¸Ä¶¯µ¥¶ÀµÄJSON SchemaÎļþÀ´´¢´æÊý¾Ý¿âϵͳ¡£´ó¼ÒÊÇ·ñÓÐÌá¼°£¬ÕâÒ²ÊÇÓÉÓû§½çÃæ³öʾµÄ£¿ÎÞÐèÔÙÕÒÑ°Åä¶ÔµÄÀ¨»¡»òȱÉٵĿոñ·û£¬Ò²ÎÞÐèÁ˽âJSON SchemaµÄʤ°Ü¡£
¡¡¡¡¼¤ÀøÆ÷ÖØ£¬·ÀÖ¹·´¸´¡£
¡¡¡¡µ±Ç£Éæµ½API½¨Ä£Ê±£¬·ÀÖ¹ÎÞЧÀͶ¯¿ÉÄÜÊÇÈ¡µÃ³É¹¦ºÍ²»³É¹¦µÄ²î±ð¡£¼ÙÈçÄãµÄÈ«²¿½Úµã¶¼ÒÔÉÔ΢²»Ò»ÑùµÄ·½·¨Ôٴν¨Á¢Í¬ÑùµÄʵÌåÄ£ÐÍ£¬ÄãÔõÄÜʵÐÐÒ»ÖÂÐÔÄØ£¿(ÌáÐÑ£¬Äã²»ÄÜ)
¡¡¡¡StudioµÄͼÐνçÃæJSON·½Ê½ÔÚÏß±à¼Æ÷ÈÝÐíÄúѸËÙÑ°ÕÒÒªÒýÈëµÄʵÌåÄ£ÐÍ¡£
¡¡¡¡StudioÈÝÐíÄúÔÚ±ØÐëµÄÇé¿öÏÂѸËÙ¡¢ÇáÇáËÉËɵØÑ°ÕÒ²¢Æ÷ÖØÄú±ØÐëµÄÄ¿±ê¡£ÒѲ»±ØÐëΪ²»Ò»ÑùµÄ½ÚµãÔٴδ´½¨Ä£ÐÍ£¬ÒѲ»±ØÐëÓÉÓÚ¼ÓÉÏÁËеÄ×Ö¶ÎÃû¶øÉý¼¶¼¸Ê®¸ö²»Ò»ÑùµÄ½Úµã¡£
¡¡¡¡ÒªÕÆÎÕ´óÁ¿ÓйØÔõÑùÔËÓÃÒýÈëÀ´ÍØÕ¹ÄúµÄAPIÒ»ÖÂÐÔµÄÐÅÏ¢£¬Çë¿´ÕâÀï¡£
¡¡¡¡¼¼ÊõÐÔÎĵµ
¡¡¡¡»ìºÍAPI²ÎÕÕÎĵµºÍ¸ù¾ÝMarkdownµÄÊֲᡢ²Ù×÷²½Öè¡¢ÐÂÊÖÈëÃÅÐÅÏ¢µÈ¡£ÄúµÄÈ«²¿Îĵµ¶¼Äܹ»·Åµ½Í¬Ò»¸öÐÂÏîÄ¿ÖС£Studio°üº¬Ò»¸öÄÚǶµÄmarkdownÔÚÏß±à¼Æ÷£¬Í¼Ïó¹ÜÀí¹¤¾ß£¬¼°Æ佫Îĵµ¹«²¼µ½StoplightеÄÎĵµ·þÎñƽ̨µÄ¹¤×÷ÄÜÁ¦¡£
¡¡¡¡½¨Á¢ºÃ¿´ÇÒ±ãÓÚÓ¦ÓõÄAPI²ÎÕÕÎĵµ
¡¡¡¡ÄúÄËÖÁÄܹ»½«Îĵµ´¢·ÅÔÚÄú×ÔÉíµÄ Git ¿â·¿ÖУ¬ËæºóÔÚÄú×¼±¸ºÃÕ¹ÏÖÄúµÄȫкÍ×î½Ü³öµÄÖø×÷ʱ¹«²¼¡£
¡¡¡¡ÒªÕÆÎÕ´óÁ¿ÓйØÔÚStudioÖÐ׫д¼¼ÊõÐÔÎĵµµÄÐÅÏ¢£¬¿ÉÒÔ¿´´ó¼ÒµÄÐÂÊÖÈëÃÅÊֲᡣ
¡¡¡¡¿îʽÊÖ²áºÍÈÏÖ¤
¡¡¡¡Ó¦ÓøÃÉ豸Spectral¼¯³É»¯À´ÉêÇëÇ¿ÖÆÖ´ÐÐ׼ȷÐÔºÍ×î¼Ñʵ¼ù£¬²¢ÔÚ½¨Á¢²»ÕýȷʱÏòÄú´«³ö±¨¾¯¡£
¡¡¡¡Spectral»áÈÏÖ¤ºÍ¹ýÂÇÄúµÄAPI£¬ÒÔ±£Ö¤ ËûÃǵÄ׼ȷÐԺͶ๦ÄÜÐÔ¡£
¡¡¡¡µãһϲ»ÕýÈ·»ò¾¯Ê¾£¬Äú»¹»á¼ÌÐø¼ûµ½ËûÃÇÔÚÎĵµÖеÄ׼ȷ²¿Î»£¬½ø¶øÄܹ»ÇáÇáËÉËɵØÔÚ¸ùÔ´ÐÞ²¹²»ÕýÈ·¡£
¡¡¡¡ÒªÕÆÎÕ´óÁ¿ÓйØSpectralµÄÐÅÏ¢£¬¼°ÆäÈÏÖ¤ÔõÑù¸Ä½øÄúµÄAPIÉè¼Æ¹¤×÷ÄÚÈÝ£¬Çë¿´ÕâÀï¡£
¡¡¡¡Built-in Mocking
¡¡¡¡µ±ÔÚµ±µØÔË×÷ʱ£¬Studio½«È«×Ô¶¯ÎªÐÂÏîÄ¿Öн綨µÄÿһ¸öAPIÆ𶯵±µØPrism·ÂÕæÄ£ÄâÍøÂç·þÎñÆ÷£¬²¢ÔÚÄú±ä¸üÉè¼Æʱά³Ö¸Ã·ÂÕæÄ£ÄâÍøÂç·þÎñÆ÷µÄÉý¼¶¡£
¡¡¡¡·ÂÕæÄ£ÄâÈÝÐíÄãÒ»Ö±ÔÚ½øµ½±àÂëÒÔǰѸËÙ¼ì²âÄãµÄAPIµÄÍâÐͺ;õµÃ¡£
¡¡¡¡ÒªÕÆÎÕ´óÁ¿ÓйØPrismµÄÐÅÏ¢£¬¼°ÆäÔõôʹÓ÷í´ÌÀ´¼òµ¥»¯ÄãµÄAPI¿ª·¢Á÷³Ì£¬Çë¿´ÕâÀï¡£
¡¡¡¡ÄÚÖð汾¿â
¡¡¡¡ÒòΪStudioÓëÄãµÄµ±µØϵͳÎļþÒ»Æð¹¤×÷ÖУ¬ÄãÄÜ¿ªÆôÄãµÄAPIÐÂÏîÄ¿£¬²¢¸Õ¿ªÊ¼¼ÓÉÏÎĵµºÍÉè¼Æ£¬¼°ÆäËûÃÇËùÒªÐðÊöµÄ¾ßÌåÍê³É¡£Ò»µ©½øÐУ¬¾Í¿ÉÒÔÓÃÄã×î°®µÄGitÊÖ»ú¿Í»§¶Ë½«ÆäËùÓвéÑéµ½GitÖС£
¡¾°æ±¾¸üС¿
¡¡¡¡½«SpectralÉý¼‰µ½v5.5.0-beta8¡£
¡¡¡¡ÐÞ²¹Á˱êʶ´úÂë¿éµÄÓÐÎó3DäÖȾ¡£
¡¡¡¡µ÷Õû ´Ó°üÀ¨Ñ»·ÒýÓõÄOpenAPIÎĵµÖÐÍÆËÍHTTPÒªÇóʱµÄ±¼À£¡£
UML½¨Ä£¹¤¾ßÊÇÓÃÓÚ´´½¨UMLÀàͼ¡¢Éú³ÉÀàͼºÍÆäËûÀàÐ͵Äͳһ½¨Ä£ÓïÑÔ£¨UML£©Í¼µÄ¹¤¾ß¡£¶ÔÓÚÈí¼þ¿ª·¢ÈËÔ±À´Ëµ£¬UML½¨Ä£ÓÐÖúÓÚËûÃÇÀí½âºÍÉÈí¼þÐèÇ󣬲¢´Ù½øϵͳ¼Ü¹¹ºÍ¹¦ÄܵÄͨÐÅ¡£Ðí¶àUML½¨Ä£¹¤¾ß¶¼ÊǾßÓпìËÙ¿ª·¢¡¢Áé»îÐԺͿÉÀ©Õ¹ÐÔ£¨ZJ£©µÄ¿ªÔ´ÏîÄ¿¡£ÔÚÕâÀÎÒÃÇÍƼöһЩÃâ·ÑµÄUML½¨Ä£¹¤¾ß°üÀ¨ÔÚÕâ¸öÍøÕ¾ÉÏ£¬ÒÔ±ãÏÂÔØ¡£¶àÌØÈí¼þרÌâΪÄúÌṩuml½¨Ä£¹¤¾ß,ϵͳ¹¤³Ì½¨Ä£¹¤¾ß,Èí¼þ¹¤³Ì½¨Ä£¹¤¾ß¡£¶àÌØÈí¼þÕ¾Ö»ÌṩÂÌÉ«¡¢ÎÞ¶¾¡¢ÎÞ²å¼þ¡¢ÎÞľÂíµÄ´¿ÂÌÉ«Èí¼þÏÂÔØ¡£
¶àÌØÈí¼þרÌâΪÄúÌṩģÐÍÈí¼þ,ÈËÎïÄ£ÐÍÈí¼þ,Á¢ÌåÄ£ÐÍÈí¼þ£¬°²×¿Æ»¹û°æÈí¼þappÒ»Ó¦¾ãÈ«¡£
¶àÌØÈí¼þרÌâΪÄúÌṩ½¨Ä£Èí¼þ,3d½¨Ä£Èí¼þ,ÊÖ»ú½¨Ä£Èí¼þ£¬°²×¿Æ»¹û°æÈí¼þappÒ»Ó¦¾ãÈ«¡£
¶àÌØÊÖÓÎרÌâΪÄúÌṩÊÖ»ú½¨Ä£app,ÊÖ»úÈËÎィģ¡£°²×¿Æ»¹û°æÒ»Ó¦¾ãÈ«,ÕÒÊÖ»ú½¨Ä£app¾ÍÀ´¶àÌØÈí¼þÕ¾ÏÂÔØ!
¶àÌØÈí¼þվΪÄúÌṩcad½¨Ä£Èí¼þרÌâ,ÔÚÕâÀïµçÄ԰氲׿°æÆ»¹û°æµÈÓ¦ÓÃÓ¦Óо¡ÓУ¬ÕÒcad½¨Ä£Èí¼þ¾ÍÀ´¶àÌØÈí¼þÕ¾¡£