ááá¯ááºáááá¯áááºáá±á¬ááºááŸá¯áá»á¬ážá áááºááŒáœáá±á¬ááá¹áá¬ááœááºá áááºááá·áºá¡áá¬áááᯠááŒá±á¬ááºážáá²ááá¯ááºáááºâáááºááá·áºá¡á áááºá¡ááá¯ááºážááá¯áááᯠááá°áá®áá±á¬áá±á¬ááºáá»á¬ážááŸáá·áº áááá¯áá¬áááºáá¬áá»á¬ážááᯠá¡áá¯á¶ážááŒá¯á ááá°áá®áá±á¬áá¬áá¬á áá¬ážááŒáá·áº ááŒááºáááºáá±ážáá¬ážááá¯ááºáááºá á¡ááœááºážááá¯ááºážá¡ááœááºááá¹áá¬ááºáááœá²ááŒá¬ážáá² á¡ááŒá²áááºážá¡ááŒá±áá¶á¡áá»áá¯á·ááœáẠááŒááºáá០microservice áá»á¬ážááŸáá·áº á¡ááŒááºá¡ááŸááºá¡áá»áá¯ážáááºáá±á¬ááºááŸá¯ááŸáá á±áááºá¡ááœáẠá á¬áá»á¯ááºáá»á¬ážáᬠáááŒá±á¬ááºážáá²ááá·áºáá«á ááá±á·áá»áœááºá¯ááºááá¯á·ááẠá á¬áá»á¯ááºáá»á¬ážááá¯áá±á¬áºááŒááẠáá±á¬áºáááºááœá±ážáá»ááºááŒááºážááŸáá·áº áá»áœááºá¯ááºááá¯á·ááœá±á·ááŸááá²á·áá±á¬ ááŸá±ážáá±á¬ááºážáá á¹á ááºážáá»á¬ážááᯠáá»áŸáá±ááŒááºážá¡ááœáẠáá»áœááºá¯ááºááá¯á·áááŒá¿áá¬á¡ááŒá±á¬ááºáž ááœá±ážááœá±ážáá«áááºá
ááŒááºáááºáá¬ážáá±á¬ ááá¯á·á
áº
ááá¯ááºáááá¯áááºáá±á¬ááºááŸá¯áá»á¬ážá Acronis Cyber ââââCloud ááᯠáá®ááœááºáá±á¬á¡áá«á áááºážááá¯á·ááᯠáá»áœááºá¯ááºááá¯á· áááœááºááŒá±á¬ááºááá¯ááºááŸááºáž áá»áœááºá¯ááºááá¯á· ááá±á¬áá±á«ááºáá²á·áááºá microservice á interface ááá¯ááá¯ááºá á¬ážááŒá¯áá±á¬á á¬áá»á¯ááºááá¯ááá¬ážáááºáááŒá¯áá² microservice ááá¯áá®ááá¯ááºážááœá²áááºáááŒá áºááá¯ááºáá«á
ááá¯á·áá±á¬áº áá¯ááºáá¯ááºáá áºáá¯ááœáẠá¡á áááºá¡ááá¯ááºážáá áºáá¯áááºááá¯á áá«áááºááŒá®áž á á¬áá»á¯ááºáááºáá±á¬ááºááŸá¯ááẠáá¯á¶ááŸááºáá¯ááºáá±á¬ááºááŸá¯áá áºáá¯ááŒá áºáá¬áá±á¬á¡áá«á áá¯ááºáááºážá áẠá¡áá±á¬ááºážáá¯á¶ážááŒá áºá¡á±á¬áẠáááºá á¥áºážá á¬ážááẠááá°áá®ááá¯ááºáá«á ááŒá¬ážáᶠ(á á¬áá»á¯ááº) ááŸáá·áº á¡áá±á¬ááºá¡áááºáá±á¬áºááŸá¯ (microservice) ááá¯á·ááẠáá áºáá¯ááŸáá·áºáá áºáᯠáá°áá®ááááºááŒá áºááŒá®ážá ááá°áá®áá±á¬ á¡á áááºá¡ááá¯ááºážáá»á¬ážááẠáá°áá®áá±á¬á¡áá¬áá»á¬ážááᯠáá°áá®á áœá¬áá¯ááºáá±á¬ááºááááºá ááá¯áá¯á¶ážááŒááºáá»ááºáá»á¬ážá¡á¬ážáá¯á¶ážááᯠáááá¯áá»á¯ááºááá¯ááºáá±á¬ áá¯á¶ážááŒááºáá»ááºááá»áá²á á¡ááœá²á·áá áºáá¯á á®ááᯠáááŒá áºááá±áá¯ááºáá±á¬ááºááááºá áááºážááá¯á·ááᯠááá°ááẠá¡áááºááẠá¡áá»áááºááŒá¯ááºážáá«á
Amazon microservices diagram ááŸ
á¡áá»ááºááá¯ááºááŒááºážáá¬áž á¡áááºáááºážá á¡ááŸááºááŸá¬á Google á០ááá¯ááºáááá¯áááºáá±á¬ááºááŸá¯áá»á¬ážááᯠá¡ááŒááºá¡ááŸááºáá¯á¶á·ááŒááºááẠáááºážáááºážááŸá
áºáá¯ááŸáááẠ- HTTP Rest ááŸáá·áº gRPC á Google ááááºážááá¬á¡á
á¯á¡áá±ážááœáẠááááºáá±á¬ááºá
á±ááá¯áá² HTTP Rest ááᯠááœá±ážáá»ááºáá²á·áááºá HTTP REST á
á¬áá»á¯ááºáá« ááŸááºáá»ááºáá»á¬ážááᯠáá±á¬áºáááºááŸá
áºáá»áá¯ážáá²á០áá
áºáá¯ááŒá
áºááá·áº RAML ááŸáá·áº OAS ááœáẠáá±á¬áºááŒáá±á·ááŸááá«áááºá ááá¯á·ááŒá±á¬áá·áºá ááœá¶á·ááŒáá¯ážááá¯ážáááºáá±ážá¡ááœá²á·ááá¯ááºážááẠá
á¶ááŸá¯ááºážáá»á¬ážáá²á០áá
áºáá¯ááᯠááœá±ážáá»ááºááẠááá¯á¡ááºáá«áááºá áá«áá±ááá·áº ááœááºáá±á«áº áá¬áá²á·á¡ááœáẠáá®ááœá±ážáá»ááºááŸá¯ áá¯ááºááá¯á· á¡áááºážáááºáá²ááá¯ááºáá«áááºá
ááŸááºáá»ááºáá»á¬áž á¡áááºááŒá±á¬áá·áº ááá¯á¡ááºááááºážá
ááŒááºáá¡áá¯á¶ážááŒá¯áá°áá áºáŠážááẠáááºážá HTTP á¡ááºáá¬áá±á·á áºááŸáá áºááá·áº ááá·áºáááºáá±á¬ááºááŸá¯ááŸáá·áº áááºááá¯á·áá¯ááºáá±á¬ááºááá¯ááºáááºááᯠá¡ááœááºááá° ááááŸáááá¯ááºá á±áááºá¡ááœáẠááŸááºáá»ááºááá¯á¡ááºáá«áááºá ááá¯ááá¯áááºááŸá¬ á¡ááŒá±áá¶á¡ááá·áºááœááºá ááŸááºáá»ááºááœáẠá¡áááºážáá¯á¶ážáááŸáááá¯ááºááá·áºáááºážááŒá áºáá»á¬ážá á¬áááºážá áááºážááá¯á·á HTTP áááºážáááºážáá»á¬ážá áá±á¬ááºážááá¯áá»ááºá¡ááœá²á·áá»á¬ážá ááá·áºáááºáá»ááºáá»á¬ážá á¬áááºážá ááá¯á¡ááºáá±á¬ááŸáá·áº áá¶á·ááá¯ážáá±ážáá¬ážááá·áº áá±á«ááºážá á®ážáá»á¬ážá ááœáŸááºááŒáá»ááºá¡ááŒáẠááŒááºáá±ážáá¯ááºáá»á¬ážááŸáá·áº áá¯á¶á·ááŒááºááŸá¯áá±á¬áºáááºáá»á¬áž áá«áááºááá«áááºá á á¬áá»á¯ááºááŸááºáá»ááºá á¡ááœááºá¡áá±ážááŒá®ážáá±á¬á¡áá»ááºááŸá¬ áááºážááá¯á·áááŸá¯ááºááŒáá·áºáá±á¬áºááŒáá»ááºááŒá áºááẠ("áá±á¬ááºážááá¯ááŸá¯ááœáẠá€áá±ážááŒááºážáá»ááºáá«áá¬áá®áá¬ááᯠáááºááá·áºááœááºážáá«á áá¬ááŒá áºáááºáááºáž"á "áá¯áẠ400 ááᯠáááºá¡ááŒá±á¡áá±ááŸá¬ ááŒááºáá±ážááŸá¬áá²")
ááá¯á·áá±á¬áºá microservices á¡áá»á¬ážá¡ááŒá¬ážááᯠáá±á¬áºáá±á¬ááºááá·áºá¡áá«ááœááºá áááºááẠáá±ážáá¬ážáá±á¬ ááŸááºá á¬áá»á¬ážá០áááºáá±á¬ááºážáááºááá¯ážááᯠáá¯ááºáá°ááá¯áá«áááºá á¥ááá¬á¡á¬ážááŒáá·áºá RAML/Swagger ááá¯á¡ááŒá±áá¶á áááºááẠáááá¯ááááºážáááºážáá¬áá¬á áá¬ážáá»á¬ážá áœá¬ááŒáá·áº client ááŸáá·áº server code ááŸá áºáá»áá¯ážáá¯á¶ážááᯠáááºáá®ážááá¯ááºáááºá microservice á¡ááœáẠá á¬ááœááºá á¬áááºážáá»á¬ážááᯠá¡ááá¯á¡áá»á±á¬ááºáááºáá¶ááá¯ááºááŒá®áž áááºážááᯠáááºá developer-portal ááá¯á· á¡ááºáá¯ááºáá¯ááºááá¯ááºáá«áááºá
áááºáá±á¬ááºáá¬ážáá±á¬ á
á¬áá»á¯ááºáá±á¬áºááŒáá»áẠááá°áá¬
á á¬áá»á¯ááºáá±á¬áºááŒáá»ááºáá»á¬ážá¡áá±á«áº á¡ááŒá±áá¶á á¡áá±ážá á¬ážáááºáá±á¬ááºááŸá¯áá»á¬ážááᯠá ááºážáááºááá·áºá¡áá±á·á¡áááŸá¬ á¡áá¯á¶ážáááºážáá«áááºá á¡áááºá áááºááẠááŸááºáá»ááºáá áºáá¯ááŸáá·áº á¡á áááºá¡ááá¯ááºážáá áºáᯠááŸá áºáá¯á áá¯á¶ážááᯠáá±ážááŒá®ážáá«áá ááá¯á·áá±á¬áẠáááºáá±á¬ááºááŸá¯á áá¯á¶áá±á¬ááºááŸá¯á¡á¬áž á á áºáá±ážááá·áº autotest áá áºáá¯ááᯠáááºáá®ážááá¯ááºáááºá áááºáá±á¬ááºááŸá¯ááẠááŸááºáá»ááºááœááºáá±á¬áºááŒáá¬ážááŒááºážáááŸááá±á¬ áá¯á¶á·ááŒááºááŸá¯áá¯ááºááᯠááŒááºáá±ážáá«ááá¬ážá ááŸá¬ážááœááºážáá±áá±á¬ á¡áá»ááºá¡áááºáá»á¬ážááᯠááŸááºáááºá áœá¬ áá¯ááºáá±á¬ááºááá¯ááºáá«áááºáá¬ážá
ááá¯á·á¡ááŒááºá á á¬áá»á¯ááºáá»á¬ážááᯠáááºážááá¯á·ááá¯ááºááá¯ááºáá¬áá ááŸááºáá»ááºáá»á¬ážááᯠáá¯á¶áá±á¬áºááŒááºážá¡ááœáẠáááááá¬áá»á¬ážááẠmicroservice ááŸáá·áº á¡áá¯ááºááᯠááá¯ážááŸááºážááœááºáá°á á±áááºá¡ááœáẠá¡áááºá¡ááœá±ážááŒáá·áº á¡áá±á¬ááºá¡áááºáá±á¬áºááŸá¯ááá¯áááºáž ááŒá áºá á±áááºá ááá¯ááá¯áááºááŸá¬á áááá¯áá¬ááá¬ááŸááºááẠá á¬áá»á¯ááºááᯠá¡áááºá¡áá»ááºážááŒáá·áºáá®á áœá¬áá±á¬áºááŒáá«á áááºážááá¯á¡ááŒá±áá¶á áá®ááá¯ááºáá¬áá»á¬ážááŸáá·áº áá®ááœááºáá°áá»á¬ážááẠá¡áá»áááºá¡ááá¯áá¯ááºáá»á ááááºáááŸááá² á¡ááŒá¬ážáá¯ááºáá¯ááºáá»á¬ážááœáẠáááºáá±á¬ááºááŸá¯ááᯠá¡áá±á¬ááºá¡áááºáá±á¬áºáááºááŒá áºáááºá
áááºáá±á¬ááºážáááááá¬áá»á¬ážááᯠááœáá·áºáááºá RAML ááŸáá·áº OAS ááŸá
áºáá¯á
áá¯á¶ážááẠá
á¶á¡á¬ážááŒáá·áº áá±ážáá±á¬ááºáá¬ážááŒááºážáááŸááá±á¬ áááºáá¬áá±áá¬ááᯠááá·áºááœááºážááá¯ááºááẠ(
áá±áá¯áá»á¡á¬ážááŒáá·áºá microservices á¡ááœáẠáááºáááá¯ááºáá»á¬ážááᯠá¡áá¯á¶ážááŒá¯áá¬ááœáẠáááºáá®ážááá¯ááºááŸá¯á¡ááá¯ááºážá¡áá¬ááẠááŒá®ážáá¬ážáááº... á¡áááºážáá¯á¶áž áá®á¡áá¯áá®á¡áá
ááŒáœá±ááŸáá·áº ááŒá°áá±á¬ááºááᯠááŸáá¯ááºážááŸááºááŒááºážá
áááºááŸáááœáẠAcronis á áŠážá á¬ážáá±áž ááœá¶á·ááŒáá¯ážááá¯ážáááºááŸá¯ á§áááá¬ááẠAcronis Cyber ââPlatform á ááœá¶á·ááŒáá¯ážááá¯ážáááºááŸá¯ ááŒá áºáááºá Acronis Cyber ââââPlatform ááẠAcronis Cyber ââââCloud ááŸáá·áº á¡á±ážáá»áá·áºá¡ááá¯ááºážááá¯á·ááŸáá·áº ááŒááºáááŸáááºáá±á¬ááºááŸá¯áá»á¬áž áá±á«ááºážá ááºááŸá¯áá¡áá»ááºáá»á¬ážá¡áá áºááŒá áºáááºá RAML ááœááºáá±á¬áºááŒáá¬ážáá±á¬ áá»áœááºá¯ááºááá¯á·áá¡ááœááºážááá¯ááºáž API áá»á¬ážááᯠáá»áœááºá¯ááºááá¯á· áá»á±á¬áºááœáŸááºáá²á·ááŒáá±á¬áºáááºáž API ááᯠáááºáá¶áá¯ááºáá±ááẠááá¯á¡ááºááŒááºážááŒá±á¬áá·áº ááœá±ážáá»ááºááŸá¯áá±ážááœááºážáá¯ááºáá²á·áááº- áá»áœááºá¯ááºááá¯á·áá¡áá¯ááºá¡ááœáẠáááºááá·áºááŸááºáá»ááºá á¶ááŸá¯ááºážááẠá¡áá±á¬ááºážáá¯á¶ážááŒá áºááááºážá
á¡á ááá¯ááºážááœááºá á¡ááœá±á·ááá»á¬ážáá±á¬ááá¯ážáááºááŸá¯áá»á¬ážááŸá¬ RAML ááŸáá·áº Swagger (ááá¯á·ááá¯áẠOAS) áá°á ááŒá±ááŸááºážáá»ááºááŸá áºáá¯ááŸááá¯á¶ááááºá ááá¯á·áá±á¬áº á¡ááŸááºááááºááœáẠá¡áááºážáá¯á¶áž ááœá±ážáá»ááºá áᬠ2 áá¯ááá¯ááºáá±á¬áºáááºáž 3 ááá¯á·ááá¯áẠááá¯á·áááºáá ááŸááááºááᯠááœá±á·ááá«áááºá
áá áºáááºááœáẠRAML - á¡á áœááºážáááºááŒá®áž áááá±á¬ááºáá±á¬áá¬áá¬á áá¬ážáá áºáá¯ááŸááááºá áááºážááẠá¡áááºáááºážááŸáá·áº á¡ááœá±áááºáá¶ááŸá¯ááᯠáá±á¬ááºážááœááºá áœá¬ áá±á¬áºáá±á¬ááºáá±ážáá±á¬ááŒá±á¬áá·áº á€áá±á¬áºáááºááẠáá±á¬áºááŒáá»ááºáá»á¬ážá áœá¬ ááá¯á¡ááºááá·áº áá¯áá¹ááá®ááŒá®ážáá»á¬ážá¡ááœáẠááá¯ááá¯ááá·áºáá»á±á¬áºááẠ- ááá¯ááá¯áááºááŸá¬ áá¯ááºáá¯ááºáá áºáá¯áááºážááá¯ááºáá² á á¬áá»á¯ááºáá»á¬ážá áá¯á¶á¡á áááºá¡ááá¯ááºážáá»á¬ážáá«ááŸááá±á¬ microservices á¡áá»á¬ážá¡ááŒá¬áž - á á áºááŸááºááŒá±á¬ááºážá¡áá±á¬ááºá¡áá¬ážá áá áºáá»á¬ážá áá°áá®áá±á¬áá±áá¬á¡áá»áá¯ážá¡á á¬ážáá»á¬ážá á¡ááŸá¬ážá¡ááœááºážá¡ááœá²á·áá»á¬áž .
ááá¯á·áá±á¬áº RAML á developer ááŒá
áºáá±á¬ Mulesoft ááẠááœá¶á·ááŒáá¯ážáá²ááŒá
áºáá±á¬ Open API áá¯ááºáááºážá
á¯ááŸáá·áº áá°ážáá±á«ááºážáá¬ážáááºá
áá áºáá¯áááºážá¡ááœááºááá¯ááºáááº...
ááœááºáá±á«áºáá¬ááá·áºá¡ááá¯ááºážá open-source utilities á¡á¬ážáá¯á¶ážááᯠOAS 3.0 ááá¯á· ááœááºážáá¶ááœááºážáá¶áá¬ážáááºá Go ááŸá ááá¯ááºáááá¯áááºáá±á¬ááºááŸá¯áá»á¬ážá¡ááœááºá á¡áá±ážááŒá®ážáá¯á¶ážá¡áá»ááºááŸá¬ ááá¯ááºáá»á±á¬áá®ááœá±ááŸá¯ áááŸáááŒááºážáááºááŒá
áºáááºá
- á¡áá±á¬ááºá¡áá¬ážá áá á áºááŒááºážá¡á á®á¡á ááºáá»á¬ážá ááá¯ááá¯áá±á¬ááºážááœááºáá±á¬áá±á¬áºááŒáá»ááº
ááŒá®ážááŒá®á JSON Schema áá¶á·ááá¯ážááŸá¯- á¥ááá¬áá»á¬ážááá·áºááẠá áœááºážáááºááᯠá¡ááá·áºááŒáŸáá·áºáá¬ážáááºá
á¡ááŒá±á¡áá±ááẠáááºá áá¬áá±á¬ááºážáááº- á á¶áá áºáá¯ááá¯ááœá±ážáá»ááºáá±á¬á¡áá«á áá®ážááŒá¬ážá¡ááŒá¬ážááœá±ážáá»ááºá áá¬áá»á¬ážá¡ááŒá ẠRAMLá Swagger 2 ááŸáá·áº Swagger 3 ááᯠááá·áºááœááºážá ááºážá á¬ážááẠááá¯á¡ááºáááºá ááá¯á·áá±á¬áºá Swagger 2 áá¬áá»áŸáẠOpenSource áááááá¬áá»á¬ážá¡ááœáẠáá±á¬ááºážááœááºáá±á¬áá¶á·ááá¯ážááŸá¯ááŸááááºá RAML ááẠá¡ááœááºááŒá±á¬ááºážááœááºááŒááºááœááºááŸáááŒá®áž ááŸá¯ááºááœá±ážááŒá®áž Swagger 3 ááᯠá¡ááá¯ááºážá¡ááá¯ááºážá áá¶á·ááá¯ážááŸá¯ áá¶á·áá»ááºážáá±á¬ááŒá±á¬áá·áº áááºááẠá¡ááœááºá á»á±ážááŒá®ážáá±á·ááŸááá±á¬ áá°ááá¯ááºáááááá¬áá»á¬áž ááá¯á·ááá¯áẠá á®ážááœá¬ážááŒá áºááŒá±ááŸááºážáááºážáá»á¬ážááᯠá¡áá¯á¶ážááŒá¯ááááºááŒá áºáá«áááºá
ááá¯á·á¡ááŒááºá Swagger ááœáẠá¡áááºááá·áºáá¯ááºáá¬ážáá±á¬ portal áá²á·ááá¯á·áá±á¬ áá±á¬ááºážááœááºáá±á¬á¡ááºá¹áá«áááºáá»á¬ážá
áœá¬ááŸááá»áŸááº
áá
áºáá»áááºá áá»áœááºá¯ááºááá¯á·ááẠRAML ááᯠááá¯ááá¯ááŒá±á¬ááºážááœááºááŒááºááœáẠáá¬áá¬á
áá¬ážáá
áºáá¯á¡ááŒá
Ạá
áááºáá¯ááºáá±á¬ááºáá²á·ááŒá®áž ááááºá¡áá±ááŒáá·áº áá»áœááºá¯ááºááá¯á·ááá¯ááºááá¯áẠáá¯ááºáá±á¬ááºá
áá¬áá»á¬ážá
áœá¬ááᯠáá¯ááºáá±á¬ááºáá²á·ááááºá á¥ááá¬á¡á¬ážááŒáá·áºá ááá±á¬áá»ááºáá
áºáá¯ááẠutility ááá¯á¡áá¯á¶ážááŒá¯áááºá
ááœá±ážáá»ááºááẠááá¯á¡ááºáá«ááá¬ážá
RAML á¡ááœáẠááŒá±ááŸááºážáá»ááºáá»á¬ážá áá±áá áá áºááᯠááŒá®ážááŒá±á¬ááºá¡á±á¬áẠáá¯ááºáá±á¬ááºáá²á·ááŒá®ážá áá»áœááºá¯ááºááá¯á·ááẠRAML ááᯠSwagger 2 á¡ááŒá áºááá¯á· ááŒá±á¬ááºážáá²áᬠá¡ááá¯á¡áá»á±á¬áẠáá¯ááºáá±á¬ááºááŒááºážá á¡áááºááŒá¯ááŒááºážá á ááºážáááºááŒááºážááŸáá·áº áá±á¬ááºáááºááœá² ááá¯ááá¯áá±á¬ááºážááœááºá¡á±á¬áẠáá¯ááºáá±á¬ááºááẠááá¯á¡ááºááŒá±á¬ááºáž áááá¯á¶ážáá»á¯ááºáá¬áá«áááºá á€áááºááŸá¬ RAML á ááŒá±á¬ááºážááœááºááŒááºááœááºááŸáá·áº Swagger á០áááºááœá¬áááááá¬ááá¯ááºáᬠáá¶á·ááá¯ážááŸá¯ááŸá áºáá¯áá¯á¶ážááᯠá¡áá¯á¶ážáá»ááẠáááºážáááºážáá±á¬ááºážáá áºáá¯ááŒá áºáááºá
á€ááŒá¿áá¬ááá¯ááŒá±ááŸááºážáááºá á á¬áá»á¯ááºáá°ážááŒá±á¬ááºážááŒááºážááᯠáá¶á·ááá¯ážáá±ážááá·áº OpenSource áááááá¬ááŸá áºáá¯ááŸááááºá
oas-raml- converter áá±á¬áá±á¬ááẠáá¶á·ááá¯ážááá¬ážáá±á¬ utility áá áºáá¯ááŒá áºáááºá áááºážááŸáá·áºá¡áá¯ááºáá¯ááºá ááºá ááá¯ááºá¡áá»á¬ážá¡ááŒá¬ážááœáẠ"ááŒáá·áºáá»ááº" ááŸá¯ááºááœá±ážáá±á¬ RAML áá»á¬ážááŸáá·áº ááŒá¿áá¬áá»á¬ážá áœá¬ááŸáááŒá±á¬ááºáž áá»áœááºá¯ááºááá¯á·ááœá±á·ááŸááá²á·áááºá á€áááá¯ááááºááᯠJavaScript ááŒáá·áºáá±ážáá¬ážáá¬ážááŒá®áž á¡áá¬ážá¡ááá¯áá áºáááºáá áºáá¯á áááºáá«ááá²áá²ááŒááºáááºážááŸá¯ááᯠáá¯ááºáá±á¬ááºáááºá ááá¯ááºážááá áºá á¬ááá¯ááºááŒááºážááŒá±á¬áá·áºá á€áá¯ááºááᯠáá¬ážáááºááẠáááºáá²áá¬áá±á¬ááŒá±á¬áá·áº áá±áá¯á¶ážáá±áá±á¬ utility á¡ááœáẠáá¬áá±ážáá»á¬ážááᯠá¡áá»áááºáááŒá¯ááºážááẠáá¯á¶ážááŒááºáá²á·áááºáwebapi-parser - á¡áá¬áááºááááºážááŸáá·áº áááºááá·áºáááºážááŒá±á¬ááºážááá¯áááᯠááŒá±á¬ááºážáá²ááẠá¡áááºááá·áºááŸááááºáᯠááá¯áá¬ážáá±á¬ áá°áá®áá±á¬áá¯áá¹ááá®á០áááááá¬áá áºáá¯á ááá±á·á¡ááá RAML 0.8á RAML 1.0 ááŸáá·áº Swagger 2.0 á¡ááœáẠáá¶á·ááá¯ážááŸá¯ááᯠááŒá±áá¬áá¬ážáááºá ááá¯á·áá±á¬áº áá»áœááºá¯ááºááá¯á·á áá¯áá±ááááŒá¯áá»áááºááœáẠá¡áá¯á¶ážáááºááŸá¯ááŸá¬ ááŸááá±áá²ááŒá áºáááºáá¡ááœáá·áºá¡ááœáẠá áá¯á áœááºááŒá®áž á¡áá¯á¶ážáááŒá¯ááá¯ááºáá«á Developer ááœá±á áá áºáá»áá¯ážáááºáá®ážáááºáIR áááºážááá¯á·á¡á¬áž á¡áá¬áááºááœáẠá á¶ááŸá¯ááºážá¡áá áºáá»á¬áž áá»ááºááŒááºá áœá¬ ááá·áºááœááºážááá¯ááºá á±ááŒááºážá áá«áá±ááá·áº á¡áá¯áááá±á¬á· á¡áá¯ááºáááŒá áºáá±ážáá«áá°ážá
á¡á²áá«á áá»áœááºáá±á¬áºááá¯á· ááŒá¯á¶ááœá±á·ááá²á· á¡áááºá¡áá²ááœá± ááá¯ááºáá°ážá áá»áœááºá¯ááºááá¯á·á ááá¯ááºááá¯ááºážááŸá á¡ááá·áºáá»á¬ážáá²á០áá áºáá¯ááẠááá¯ááŸá±á¬ááºááŸá¯á០RAML ááẠáááºááŸááºáá»ááºááŸáá·áº áááºááá¯ááºááŒá±á¬ááºáž á á áºáá±ážáááºááŒá áºáááºá áá»áœááºá¯ááºááá¯á·ááẠá¡áá¯á¶ážáááºááŸá¯áá»á¬ážá áœá¬ááᯠááŒáá¯ážá á¬ážáá²á·áááºá á¡á¶á·ááŒá áá¬áá±á¬ááºážáá¬áá áá°ááá¯á·á¡á¬ážáá¯á¶ážáᬠááá°áá®áá²á· áá±áá¬ááœá±ááŸá¬ áá»áœááºá¯ááºááá¯á·áá²á· ááŸááºáá»ááºáá»á¬ážááᯠá¡áá»áá¯ážáá»áá¯ážáá±á¬ ááá¯ážááœááºážáá²á· á áá¬ážáá¯á¶ážáá»á¬ážááŒáá·áº áá»áááºááá¯áá²á·ááŒáá«áááºá á¡ááŒá²áááºáž á¡ááŸááºáááá±áá«áá²á·á
á¡áá¯á¶ážááœááºá áá»áœááºá¯ááºááá¯á·ááẠááŒá¿áá¬áá»á¬ážá áœá¬ááŸááá±ááẠ(áá áºáá«áá áºáᶠá¡ááŒá¬áá±á¬ááºáá»ááºááœá¬ážáááºá áá¯á¶ááŸááºá¡áá¯á¶ážá¡ááŸá¯ááºážáá»á¬ážááŒáá·áº á¡áá¯ááºáá¯ááºáá±á¬á¡áá« ááŒá¿áá¬áá»á¬ážááŸááááº)á ááá¯á·ááŒá±á¬áá·áºá áá»áœááºá¯ááºááá¯á·ááẠá¡ááá²á·áááááá¬áá»á¬ážááᯠá¡ááŒá±áá¶á ááá¬ážáááºá¡áááºááŒá¯ááŒááºážááŸáá·áº ááŒá±á¬ááºážáá²ááŒááºážááá¯ááºáᬠááŒá¿áá¬áá»á¬ážááᯠááŒá±ááŸááºážááẠáááºážáááºážááŸá¬áááœá±á·áááŒáá·áº á á®ážááœá¬ážááŒá Ạá¡áá¯á¶ážáááºááŸá¯ááᯠá¡áá¯á¶ážááŒá¯ááẠáá¯á¶ážááŒááºáá²á·áááºá á¡áá¬áááºááœááºá OpenSource áááááá¬áá»á¬áž ááá¯ááá¯ááá·áºáá»ááºáá¬áááºááŸáá·áºá¡áá»áŸá á€ááŒá¿áá¬ááᯠááŒá±ááŸááºážááẠááá¯ááá¯ááœááºáá°áá¬áá«áááºá á€á¡áá±á¬á¡ááœááºážá "ááŒá®ážá á®ážááŸá¯" á¡ááœáẠáá¯ááºá¡á¬ážááŸáá·áº á¡áá»áááºáá¯ááºáá»á ááááºááẠá á®ážááœá¬ážááŒá áºáááºáá±á¬ááºááŸá¯áá áºáá¯ááá¯ááºáá»á ááááºááẠáá»áœááºá¯ááºááá¯á·á¡ááœáẠááá¯á¡áá±ážááŒá®ážáá¯á¶áá±á«áºáááºá
áá±á¬ááºáá»ááº
áá«ááœá±á¡á¬ážáá¯á¶ážááŒá®ážáááºáá±á¬á· áá»áœááºá¯ááºááá¯á·áá²á· á¡ááœá±á·á¡ááŒá¯á¶ááᯠáá»áŸáá±ááá¯ááŒá®áž á á¬áá»á¯ááºáá»á¬ážááᯠáá±á¬áºááŒááŒááºážá¡ááœáẠáááááá¬áá áºáá¯ááᯠáááœá±ážáá»ááºáá®á áááºá áááºážáá¶á០áááºááá¯áá»ááºáá²á·á¡áá¬áá²á· áááºáááºážááŸá®ážááŒáŸá¯ááºááŸá¶ááá¯áá²á· áááºáá»ááºááᯠááŸááºážááŸááºážáááºážáááºáž áááºááŸááºááá¯á· ááá¯á¡ááºááŒá±á¬ááºáž áááááŒá¯áá«á OpenSource ááᯠáá±á·ááœá¬ážáá«áá ááá·áºá¡á¬áž á á áºáá±ážáááºá ááŒá±á¬ááºážáá²áááºááŸáá·áº á¡áááºááŒá¯ááẠáá°áá®áá±ážááá·áº áááºáá±á¬ááºááŸá¯áá»á¬ážááŸáá·áº áá¯ááºáá¯ááºá¡áá»á¬ážá¡ááŒá¬áž ááŸááá±ááŒá®ááŒá áºáááºá áá«áá±ááá·áº áá°ááá¯á·á áá±ážááŒá®ážááŒá®áž áá áºáá«ááá± á¡áááºážáá±ážááŒá®ážáááºá áá¯áá¹ááá®ááŒá®ážáá áºáá¯á¡ááœááºá ááá¯ááá¯á·áá±á¬áá¯ááºáá»á ááááºáá»á¬ážááẠáá¶ááá¯ááºáááºááŸááá±á¬áºáááºáž áá¯ááºáááºážá áááºáááºá¡ááœáẠáááºážááá¯á·ááẠááŒá®ážáá¬ážáá±á¬áááºáá¯ááºáááºááá¯ážááŒá áºáá¬ááá¯ááºáááºá
áá±á¬ááºááœáẠáááºá¡áá¯á¶ážááŒá¯ááá·áº áááááá¬á¡á
á¯á¶ááᯠáááºááŸááºáá«á á¥ááá¬á¡á¬ážááŒáá·áºá áááºááẠá
á¬áá»á¯ááºáá
áºáá¯ááŒáááẠááá¯á¡ááºáá«áá ááŸááá±á¬ API áá«ááŸááá±á¬ Swagger 2 ááᯠá¡áá¯á¶ážááŒá¯ááẠááá¯ááá¯ááœááºáá°áááá·áºáááºá á¡ááŒá±á¬ááºážááŸá¬ RAML ááœáẠáááºááẠáááºáá±á¬ááºááŸá¯ááᯠáááºááá¯ááºááá¯áẠáááºáá±á¬ááºááááºážááááºážááááºááŒá
áºáá«áááºá
ááá·áºááœáẠá¡áá¯ááºáá»á¬ážáá±áá±á áááááá¬áá»á¬áž ááá¯á¡ááºáá±áá±á áááºážááá¯á·ááẠááá°áá®áá±á¬ ááááºáá±á¬ááºážáá»á¬ážá¡ááœáẠááœá²ááŒá¬ážáᬠá¡áá¬áááºááœáẠááá·áºáá¯ááºáá»á
ááááºáá»á¬ážááᯠáá»á±á¬á·áááºážá
á±ááá·áº ááœá±ážáá»ááºááŸá¯áá
áºáá¯ááŒá¯áá¯ááºáááºá¡ááœáẠáááŸáááá¯ááºáá±á¬áá¬ážááŸááºážáá»á¬ážááŸáá·áº áá»ááºáá»ááºážáááºážááŸá®ážá¡á±á¬ááºááŒá¯áá¯ááºááŒááºážá ááá¯áá±á¬ááºážáá«áááºá
ááá¯á·áá±á¬áº ááá±á·áááºááŸááá±áá±á¬ áá±áá áá áºáá»á¬ážá¡á¬ážáá¯á¶áž áá á¯á¶áááºááŒá±á¬ááºáž á¡ááá¡ááŸááºááŒá¯ááá¯ááºáá«áááºá ááá¯á·ááŒá±á¬áá·áº RAML ááœááºá¡áá¯ááºáá¯ááºáááºááŸá áºáááºáá±á¬áá¯áá¹ááá®ááŸáááááááºáá»á¬ážááŸááá«á "áááºážáááºááá·áºá¡á¬ážá¡ááŒá¶á¥á¬ááºáá»á¬ážááá¯ááá¯ááá¯ááŒá±á¬ááºážááœááºááŒááºááœááºáá±á¬áºááŒááá¯ááºáááº" ááŒá±á¬áá·áºááá¯á·ááá¯áẠ"áááºážáááºááá¯ááá¯ááŸááºážáááºážáá±á¬ááŒá±á¬áá·áº Swagger ááá¯ááá¯ááá¯ááŸá áºáááºáááº" áááºáááºážááá¯á·ááá¯á¡áá¯ááºááŸááœááºááœá¬áááºá¡áá±á¬ááºážáá¯á¶ážááŒá áºáááºá áá±á¬áºáááºáá áºáá¯ááááááá¬áá»á¬ážááẠááá¯ááºáá áºáá¯ááŸáá·áº ááŒá¯ááŒááºááœááºážáá¶ááẠááá¯á¡ááºáá±á¬ááŒá±á¬áá·áº áááºážááá¯á·ááᯠá¡áá¯á¶ážááŒá¯ááŒá®áž áááºážááᯠááá¯áá»ááºáááºá
áá»áœááºá¯ááºááá¯á·áá¡ááœá±á·á¡ááŒá¯á¶á¡ááœááºá á¡á±á¬ááºáá«ááá¯á·á áºáá»á¬ážááœáẠáá»áœááºá¯ááºááá¯á·á RAML-Swagger áááá¯áá¬áááºáá¬áá»á¬ážá¡áá±á«áº á¡ááŒá±áá¶á áá»áœááºá¯ááºááá¯á·áá¯ááºáá±á¬ááºááá·áº áááºááŒáááºááŒá®áž áááºááŒáœáá±á¬á á áºáá±ážááŸá¯áá»á¬ážá á á¬áá»á¯ááºáá»á¬ážá០áá»áœááºá¯ááºááá¯á·áá¯ááºáá¯ááºááá·áº á á¬ááœááºá á¬áááºážáá»á¬ážááŸáá·áº áááºážá¡á¬ážáá¯á¶ážá¡áá¯ááºáá¯ááºáá¯á¶á¡ááŒá±á¬ááºáž ááœá±ážááœá±ážáá«áááºá
á
á¬áááºážááœááºážá¡áá¯á¶ážááŒá¯áá°áá»á¬ážáᬠá
á
áºáááºážááœáẠáá«áááºááá¯ááºáá«áááºá
ááá¯ááºáááá¯áááºáá±á¬ááºááŸá¯ á á¬áá»á¯ááºáá»á¬ážááᯠááŸááºáá¬ážááẠáááºááá·áºáá¬áá¬á áá¬ážááᯠáááºá¡áá¯á¶ážááŒá¯ááááºážá
-
RAML á
-
RAML á
-
áááºáá±á¬á· á
-
OAS3 (áá±á«áº)
-
á¡áá±ážá áááºáá¯á¶á á¶
-
á¡ááŒá¬áž
-
ááá¯á¶ážáá°ážá
á¡áá¯á¶ážááŒá¯áá° ááá áŠáž áá²áá±ážáá²á·áááºá á¡áá¯á¶ážááŒá¯áá° 100 áŠáž ááŒá¬ážáá±áá²á·áá«áááºá
source: www.habr.com