ืื™ื– ืขืก RAML ืึธื“ืขืจ OAS (Swagger)?

ืื™ืŸ ื“ื™ ื“ื™ื ืึทืžื™ืฉ ื•ื•ืขืœื˜ ืคื•ืŸ ืžื™ืงืจืึธ ืกืขืจื•ื•ื™ืกืขืก, ืึทืœืฅ ืงืขืŸ ื˜ื•ื™ืฉืŸ - ื™ืขื“ืขืจ ืงืึธืžืคึผืึธื ืขื ื˜ ืงืขื ืขืŸ ื–ื™ื™ืŸ ืจื™ืจื™ื™ื˜ ืื™ืŸ ืึท ืึทื ื“ืขืจืฉ ืฉืคึผืจืึทืš, ื ื™ืฆืŸ ืคืึทืจืฉื™ื“ืขื ืข ืคืจืึทืžืขื•ื•ืึธืจืงืก ืื•ืŸ ืึทืจืงืึทื˜ืขืงื˜ืฉืขืจ. ื‘ืœื•ื™ื– ืงืึทื ื˜ืจืึทืงืฅ ื–ืึธืœ ื‘ืœื™ื™ึทื‘ืŸ ืึทื ื˜ืฉื™ื™ื ื“ื–ืฉื“ ืึทื–ื•ื™ ืึทื– ื“ื™ ืžื™ืงืจืึธืกืขืจื•ื•ื™ืก ืงืขื ืขืŸ ื–ื™ื™ืŸ ื™ื ื˜ืขืจืึทืงื˜ื™ื“ ืžื™ื˜ ื“ื™ ืึทืจื•ื™ืก ืื•ื™ืฃ ืขื˜ืœืขื›ืข ืฉื˜ืขื ื“ื™ืง ื™ืงืขืจ, ืจืึทื’ืึทืจื“ืœืึทืก ืคื•ืŸ ื™ื ืขืจืœืขืš ืžืขื˜ืึทืžืึธืจืคืึธืกืขืก. ืื•ืŸ ื”ื™ื™ึทื ื˜ ืžื™ืจ ื•ื•ืขืœืŸ ืจืขื“ืŸ ื•ื•ืขื’ืŸ ืื•ื ื“ื–ืขืจ ืคึผืจืึธื‘ืœืขื ืคื•ืŸ ื˜ืฉื•ื–ื™ื ื’ ืึท ืคึฟืึธืจืžืึทื˜ ืคึฟืึทืจ ื“ื™ืกืงืจื™ื™ื‘ื™ื ื’ ืงืึทื ื˜ืจืึทืงืฅ ืื•ืŸ ื˜ื™ื™ืœืŸ ื“ื™ ืึทืจื˜ืึทืคืึทืงืฅ ืžื™ืจ ื’ืขืคึฟื•ื ืขืŸ.

ืื™ื– ืขืก RAML ืึธื“ืขืจ OAS (Swagger)?

ืคึผืึธืกื˜ืŸ ืฆื•ื’ืขื’ืจื™ื™ื˜ ืื ื ื ืžืขืœื›ืืฐ ะธ ื•ื•ืœืื“ื™ืžื™ืจ ืœืึทืคึผืึทื˜ื™ืŸ

ืžื™ืงืจืึธ ืกืขืจื•ื•ื™ืกืขืก. ื•ื•ืขืŸ ื“ื™ ืึทื ื˜ื•ื•ื™ืงืœื•ื ื’ ืคื•ืŸ Acronis Cyber โ€‹โ€‹โ€‹โ€‹Cloud, ืžื™ืจ ืื™ื™ื ื’ืขื–ืขืŸ ืึทื– ืžื™ืจ ืงืขืŸ ื ื™ืฉื˜ ืึทื ื˜ืœื•ื™ืคืŸ ืคื•ืŸ ื–ื™ื™. ืื•ืŸ ื“ื™ื–ื™ื™ื ื™ื ื’ ืึท ืžื™ืงืจืึธืกืขืจื•ื•ื™ืก ืื™ื– ืื•ืžืžืขื’ืœืขืš ืึธืŸ ืคืึธืจืžืึทืœื™ื™ื–ื™ื ื’ ื“ื™ ืึธืคึผืžืึทืš, ื•ื•ืึธืก ืจืขืคึผืจืึทื–ืขื ืฅ ื“ื™ ืฆื•ื‘ื™ื ื“ ืคื•ืŸ ื“ื™ ืžื™ืงืจืึธืกืขืจื•ื•ื™ืก.

ืึธื‘ืขืจ ื•ื•ืขืŸ ืึท ืคึผืจืึธื“ื•ืงื˜ ื›ึผื•ืœืœ ืžืขืจ ื•ื•ื™ ืื™ื™ืŸ ืงืึธืžืคึผืึธื ืขื ื˜, ืื•ืŸ ืงืึธื ื˜ืจืึทืงื˜ ืึทื ื˜ื•ื•ื™ืงืœื•ื ื’ ื•ื•ืขืจื˜ ืึท ืจืขื’ื•ืœืขืจ ื˜ืขื˜ื™ืงื™ื™ื˜, ืื™ืจ ืงืขื ืขืŸ ื ื™ืฉื˜ ื”ืขืœืคืŸ ืึธื‘ืขืจ ืึธื ื”ื™ื™ื‘ืŸ ืฆื• ื˜ืจืึทื›ื˜ืŸ ื•ื•ืขื’ืŸ ืคึผืจืึธืฆืขืก ืึทืคึผื˜ืึทืžืึทื–ื™ื™ืฉืึทืŸ. ืขืก ื•ื•ืขืจื˜ ืงืœืึธืจ ื•ื•ื™ ื“ืขืจ ื˜ืึธื’ ืึทื– ื“ื™ ืฆื•ื‘ื™ื ื“ (ืึธืคึผืžืึทืš) ืื•ืŸ ื™ืžืคึผืœืึทืžืขื ื˜ื™ื™ืฉืึทืŸ (ืžื™ืงืจืึธืกืขืจื•ื•ื™ืก) ืžื•ื–ืŸ ื’ืœื™ื™ึทื›ืŸ ื™ืขื“ืขืจ ืื ื“ืขืจืขืจ, โ€‹โ€‹ืึทื– ืคืึทืจืฉื™ื“ืขื ืข ืงืึทืžืคึผืึธื•ื ืึทื ืฅ ืžื•ื–ืŸ ื˜ืึธืŸ ื“ื™ ื–ืขืœื‘ืข ื˜ื™ื ื’ื– ืื™ืŸ ื“ื™ ื–ืขืœื‘ืข ื•ื•ืขื’, ืื•ืŸ ืึทื– ืึธืŸ ืึท ืกืขื ื˜ืจืึทืœื™ื™ื–ื“ ื‘ืึทืฉืœื•ืก ื’ืขืžืื›ื˜ ืคื•ืŸ ืึทืœืข ื“ื™ ื“ื™ืกื™ื–ืฉืึทื ื–, ื™ืขื“ืขืจ ืžืึทื ืฉืึทืคึฟื˜ ื•ื•ืขื˜ ื–ื™ื™ืŸ ื’ืขืฆื•ื•ื•ื ื’ืขืŸ ืฆื• ืคืึทืจื‘ืจืขื ื’ืขืŸ ืฆื™ื™ื˜ ื•ื•ื™ื“ืขืจ ืื•ืŸ ื•ื•ื™ื“ืขืจ ืฆื• ื‘ืึทืงื•ืžืขืŸ ื–ื™ื™.

ืื™ื– ืขืก RAML ืึธื“ืขืจ OAS (Swagger)?
ืึทืžืึทื–ืึธืŸ ืžื™ืงืจืึธ ืกืขืจื•ื•ื™ืกืขืก ื“ื™ืึทื’ืจืึทืžืข ืคื•ืŸ ื˜ื•ื•ืขืขื˜ ื•ื•ืขืจื ืขืจ ื•ื•ืึธื’ืขืœื™ืก, ืงื˜ืึธ ืึทืžืึทื–ืึธืŸ
ื•ื•ืึธืก ืื™ื– ื“ื™ ื“ื™ืœืขืžืึท? ื“ืข ืคืึทืงื˜ืึธ, ืขืก ื–ืขื ืขืŸ ืฆื•ื•ื™ื™ ื•ื•ืขื’ืŸ ืฆื• ื™ื ื˜ืขืจืึทืงื˜ ืžื™ืงืจืึธ ื‘ืึทื“ื™ื ื•ื ื’ืก - ื”ื˜ื˜ืคึผ ืจืขืกื˜ ืื•ืŸ gRPC ืคึฟื•ืŸ Google. ืžื™ืจ ื•ื•ืขืœืŸ ื ื™ืฉื˜ ื•ื•ืขืœืŸ ืฆื• ื›ืึทืคึผืŸ ื–ื™ืš ืื™ืŸ Google ืก ื˜ืขื›ื ืึธืœืึธื’ื™ืข ืึธื ืœื™ื™ื’ืŸ, ืžื™ืจ ืื•ื™ืกื“ืขืจื•ื•ื™ื™ืœื˜ ื”ื˜ื˜ืคึผ ืจืขืกื˜. ื”ื˜ื˜ืคึผ ืจืขืกื˜ ืงืึธื ื˜ืจืึทืงื˜ ืึทื ืึทื˜ื™ื™ืฉืึทื ื– ื–ืขื ืขืŸ ืžืขืจืกื˜ ืึธืคื˜ ื“ื™ืกืงืจื™ื™ื‘ื“ ืื™ืŸ ืื™ื™ื ืขืจ ืคื•ืŸ ืฆื•ื•ื™ื™ ืคึฟืึธืจืžืึทื˜ื™ืจื•ื ื’ืขืŸ: RAML ืื•ืŸ OAS, ืึทืžืึธืœ ื‘ืืงืื ื˜ ื•ื•ื™ ืกื•ื•ืึทื’ืขืจ.ื“ืขืจื™ื‘ืขืจ, ื™ืขื“ืขืจ ืึทื ื˜ื•ื•ื™ืงืœื•ื ื’ ืžืึทื ืฉืึทืคึฟื˜ ืื™ื– ืคื™ื™ืกื˜ ืžื™ื˜ ื“ื™ ื ื•ื™ื˜ ืฆื• ืงืœื™ื™ึทื‘ืŸ ืื™ื™ื ืขืจ ืคื•ืŸ ื“ื™ ืกื˜ืึทื ื“ืึทืจื“ืก. ืื‘ืขืจ ื•ื•ื™ ืขืก ื˜ื•ืจื ืก ืื•ื™ืก, ืžืึทื›ืŸ ื“ืขื ื‘ืจื™ืจื” ืงืขืŸ ื–ื™ื™ืŸ ื–ื™ื™ืขืจ ืฉื•ื•ืขืจ.

ืคืืจื•ื•ืืก ื–ืขื ืขืŸ ืึทื ืึทื˜ื™ื™ืฉืึทื ื– ื“ืืจืฃ?

ื“ื™ ืึทื ืึธื˜ืึทืฆื™ืข ืื™ื– ื“ืืจืฃ ืึทื–ื•ื™ ืึทื– ืึท ืคื•ื ื“ืจื•ื™ืกื ื“ื™ืง ื‘ืึทื ื™ืฆืขืจ ืงืขื ืขืŸ ืœื™ื™ื›ื˜ ืจืขื›ืขื ืขืŸ ื•ื•ืึธืก ืงืขื ืขืŸ ื–ื™ื™ืŸ ื’ืขื˜ืืŸ ืžื™ื˜ ื“ื™ื™ืŸ ื“ื™ื ืกื˜ ื“ื•ืจืš ื–ื™ื™ืŸ HTTP ืฆื•ื‘ื™ื ื“. ืึทื– ืื™ื–, ืื™ืŸ ืึท ื™ืงืขืจื“ื™ืง ืžื“ืจื’ื”, ื“ื™ ืึทื ืึธื˜ืึทืฆื™ืข ืžื•ื–ืŸ ืึทื ื˜ื”ืึทืœื˜ืŸ ืื™ืŸ ืžื™ื ื“ืกื˜ืขืจ ืึท ืจืฉื™ืžื” ืคื•ืŸ ื‘ื ื™ืžืฆื ืจืขืกื•ืจืกืŸ, ื–ื™ื™ืขืจ ื”ื˜ื˜ืคึผ ืžืขื˜ื”ืึธื“ืก, ื‘ืขื˜ืŸ ืœืœื‘ืขืจ, ืึท ืœื™ืกื˜ื™ื ื’ ืคื•ืŸ ืคึผืึทืจืึทืžืขื˜ืขืจืก, ืึทืŸ ืึธื ื•ื•ื™ื™ึทื– ืคื•ืŸ ื“ื™ ืคืืจืœืื ื’ื˜ ืื•ืŸ ื’ืขืฉื˜ื™ืฆื˜ ื›ืขื“ืขืจื–, ื•ื•ื™ ื’ืขื–ื•ื ื˜ ื•ื•ื™ ืฆื•ืจื™ืงืงื•ืžืขืŸ ืงืึธื•ื“ื– ืื•ืŸ ืขื ื˜ืคืขืจ ืคึฟืึธืจืžืึทื˜ื™ืจื•ื ื’ืขืŸ. ืึท ื’ืึธืจ ื•ื•ื™ื›ื˜ื™ืง ืขืœืขืžืขื ื˜ ืคื•ืŸ ื“ื™ ืงืึธื ื˜ืจืึทืงื˜ ืึทื ืึธื˜ืึทืฆื™ืข ืื™ื– ื–ื™ื™ืขืจ ืžื™ื ื“ืœืขืš ื‘ืึทืฉืจื™ื™ึทื‘ื•ื ื’ ("ื•ื•ืึธืก ื•ื•ืขื˜ ืคึผืึทืกื™ืจืŸ ืื•ื™ื‘ ืื™ืจ ืœื™ื™ื’ืŸ ื“ืขื ืึธื ืคึฟืจืขื’ ืคึผืึทืจืึทืžืขื˜ืขืจ ืฆื• ื“ื™ ื‘ืขื˜ืŸ?", "ืื™ืŸ ื•ื•ืึธืก ืคืึทืœ ื•ื•ืขื˜ ืงืึธื“ 400 ื–ื™ื™ืŸ ืื•ืžื’ืขืงืขืจื˜?")

ืึธื‘ืขืจ, ื•ื•ืขืŸ ืขืก ืงื•ืžื˜ ืฆื• ืึทื ื˜ื•ื•ื™ืงืœืขืŸ ืึท ื’ืจื•ื™ืก ื ื•ืžืขืจ ืคื•ืŸ ืžื™ืงืจืึธ ื‘ืึทื“ื™ื ื•ื ื’ืก, ืื™ืจ ื•ื•ื™ืœืŸ ืฆื• ืขืงืกื˜ืจืึทืงื˜ ื ืึธืš ื•ื•ืขืจื˜ ืคื•ืŸ ื“ื™ ื’ืขืฉืจื™ื‘ืŸ ืึทื ืึทื˜ื™ื™ืฉืึทื ื–. ืคึฟืึทืจ ื‘ื™ื™ึทืฉืคึผื™ืœ, ื‘ืื–ื™ืจื˜ ืื•ื™ืฃ RAML / Swagger, ืื™ืจ ืงืขื ืขืŸ ื“ื–ืฉืขื ืขืจื™ื™ื˜ ื‘ื™ื™ื“ืข ืงืœื™ืขื ื˜ ืื•ืŸ ืกืขืจื•ื•ืขืจ ืงืึธื“ ืื™ืŸ ืึท ืจื™ื–ื™ืง ื ื•ืžืขืจ ืคื•ืŸ ืคึผืจืึธื’ืจืึทืžืžื™ื ื’ ืฉืคึผืจืึทื›ืŸ. ืื™ืจ ืงืขื ื˜ ืื•ื™ืš ืื•ื™ื˜ืึธืžืึทื˜ื™ืฉ ื‘ืึทืงื•ืžืขืŸ ื“ืึทืงื™ื•ืžืขื ื˜ื™ื™ืฉืึทืŸ ืคึฟืึทืจ ื“ื™ ืžื™ืงืจืึธืกืขืจื•ื•ื™ืก ืื•ืŸ ืฆื•ืคึฟืขืœื™ืงืขืจ ืขืก ืฆื• ื“ื™ื™ืŸ ื“ืขื•ื•ืขืœืึธืคึผืขืจ ื˜ื•ื™ืขืจ :).

ืื™ื– ืขืก RAML ืึธื“ืขืจ OAS (Swagger)?
ื‘ื™ื™ึทืฉืคึผื™ืœ ืคื•ืŸ ืึท ืกื˜ืจืึทืงื˜ืฉืขืจื“ ืงืึธื ื˜ืจืึทืงื˜ ื‘ืึทืฉืจื™ื™ึทื‘ื•ื ื’

ื•ื•ื™ื™ื ื™ืงืขืจ ืคึผืจืึธืกื˜ ืื™ื– ื“ื™ ืคื™ืจ ืคื•ืŸ ื˜ืขืกื˜ื™ื ื’ ืžื™ืงืจืึธืกืขืจื•ื•ื™ืกืขืก ื‘ืื–ื™ืจื˜ ืื•ื™ืฃ ืงืึธื ื˜ืจืึทืงื˜ ื“ื™ืกืงืจื™ืคึผืฉืึทื ื–. ืื•ื™ื‘ ืื™ืจ ื”ืึธื˜ ื’ืขืฉืจื™ื‘ืŸ ื‘ื™ื™ื“ืข ืึท ืึทื ืึธื˜ืึทืฆื™ืข ืื•ืŸ ืึท ืงืึธืžืคึผืึธื ืขื ื˜, ืื™ืจ ืงืขื ืขืŸ ืžืึทื›ืŸ ืึทืŸ ืึทื•ื˜ืึธื˜ืขืกื˜ ื•ื•ืึธืก ืงืึธื ื˜ืจืึธืœื™ืจืŸ ื“ื™ ืึทื“ืึทืงื•ื•ืึทืกื™ ืคื•ืŸ ื“ื™ ืกืขืจื•ื•ื™ืก ืžื™ื˜ ืคืึทืจืฉื™ื“ืŸ ื˜ื™ื™ืคึผืก ืคื•ืŸ ืึทืจื™ื™ึทื ืฉืจื™ื™ึทื‘ ื“ืึทื˜ืŸ. ืฆื™ ื“ื™ ืกืขืจื•ื•ื™ืก ื’ื™ื˜ ืึท ืขื ื˜ืคืขืจ ืงืึธื“ ื•ื•ืึธืก ืื™ื– ื ื™ืฉื˜ ื“ื™ืกืงืจื™ื™ื‘ื“ ืื™ืŸ ื“ื™ ืึทื ืึธื˜ืึทืฆื™ืข? ื•ื•ืขื˜ ืขืก ืงืขื ืขืŸ ืจื™ื›ื˜ื™ืง ืคึผืจืึธืฆืขืก ื“ืึธืš ืคืึทืœืฉ ื“ืึทื˜ืŸ?

ื“ืขืจืฆื•, ื”ื•ื™ืš-ืงื•ื•ืึทืœื™ื˜ืขื˜ ื™ืžืคึผืœืึทืžืขื ื˜ื™ื™ืฉืึทืŸ ืคื•ืŸ ื ื™ื˜ ื‘ืœื•ื™ื– ื“ื™ ืงืึทื ื˜ืจืึทืงืฅ ื–ื™ืš, ืึธื‘ืขืจ ืื•ื™ืš ื“ื™ ืžื›ืฉื™ืจื™ื ืคึฟืึทืจ ื•ื•ื™ื–ืฉื•ื•ืึทืœื™ื™ื–ื™ื ื’ ืึทื ืึทื˜ื™ื™ืฉืึทื ื– ืžืื›ื˜ ืขืก ืžืขื’ืœืขืš ืฆื• ืคืึทืจืคึผืึธืฉืขื˜ืขืจืŸ ื“ื™ ืึทืจื‘ืขื˜ ืžื™ื˜ ื“ื™ ืžื™ืงืจืึธืกืขืจื•ื•ื™ืก. ืึทื– ืื™ื–, ืื•ื™ื‘ ื“ืขืจ ืึทืจื›ื™ื˜ืขืงื˜ ืงื•ื•ืึทืœืึทื˜ื™ื™ื˜ื™ื•ื•ืœื™ ื“ื™ืกืงืจื™ื™ื‘ื“ ื“ืขื ืึธืคึผืžืึทืš, ื‘ืื–ื™ืจื˜ ืื•ื™ืฃ ืขืก, ื“ื™ื–ื™ื™ื ืขืจื– ืื•ืŸ ื“ืขื•ื•ืขืœืึธืคึผืขืจืก ื•ื•ืขื˜ ื™ื ืกื˜ืจื•ืžืขื ื˜ ื“ื™ ื“ื™ื ืกื˜ ืื™ืŸ ืื ื“ืขืจืข ืคึผืจืึธื“ื•ืงื˜ืŸ ืึธืŸ ื ืึธืš ืฆื™ื™ื˜ ืงืึธืก.

ืฆื• ื’ืขื‘ืŸ ื ืึธืš ืžื›ืฉื™ืจื™ื, ื‘ื™ื™ื“ืข RAML ืื•ืŸ OAS ื”ืึธื‘ืŸ ื“ื™ ืคื™ื™ื™ืงื™ื™ื˜ ืฆื• ืœื™ื™ื’ืŸ ืžืขื˜ืึทื“ืึทื˜ืึท ื ื™ืฉื˜ ืฆื•ื’ืขืฉื˜ืขืœื˜ ื“ื•ืจืš ื“ื™ ื ืึธืจืžืึทืœ (ืคึฟืึทืจ ื‘ื™ื™ึทืฉืคึผื™ืœ, ื“ืึธืก ืื™ื– ื•ื•ื™ ืขืก ืื™ื– ื’ืขื˜ืืŸ ืื™ืŸ OAS).

ืื™ืŸ ืึทืœื’ืขืžื™ื™ืŸ, ื“ื™ ืคืึทืจื ืขื ืคึฟืึทืจ ืฉืขืคึฟืขืจื™ืฉืงื™ื™ื˜ ืื™ืŸ ื ื™ืฆืŸ ืงืึทื ื˜ืจืึทืงืฅ ืคึฟืึทืจ ืžื™ืงืจืึธืกืขืจื•ื•ื™ืกืขืก ืื™ื– ืจื™ื–ื™ืง ... ืื™ืŸ ืžื™ื ื“ืกื˜ืขืจ ืื™ืŸ ื˜ืขืึธืจื™ืข.

ืคืึทืจื’ืœื™ื™ึทืš ืคื•ืŸ ืึท ื”ืขื“ื’ืขื”ืึธื’ ืžื™ื˜ ืึท ืฉืœืึทื ื’

ื“ืขืจื•ื•ื™ื™ึทืœ, ื“ื™ ื‘ื™ืœื›ืขืจืงื™ื™ึทื˜ ืึทื ื˜ื•ื•ื™ืงืœื•ื ื’ ื’ืขื’ื ื˜ ืื™ืŸ Acronis ืื™ื– ื“ื™ ืึทื ื˜ื•ื•ื™ืงืœื•ื ื’ ืคื•ืŸ ื“ื™ Acronis Cyber โ€‹โ€‹Platform. Acronis Cyber โ€‹โ€‹โ€‹โ€‹ืคึผืœืึทื˜ืคืึธืจื ืื™ื– ื ื™ื™ึทืข ื™ื ืึทื’ืจื™ื™ืฉืึทืŸ ืคื•ื ืงื˜ืŸ ืคื•ืŸ ื“ืจื™ื˜-ืคึผืึทืจื˜ื™ื™ ื‘ืึทื“ื™ื ื•ื ื’ืก ืžื™ื˜ Acronis Cyber โ€‹โ€‹โ€‹โ€‹Cloud ืื•ืŸ ื“ืขืจ ืึทื’ืขื ื˜ ื˜ื™ื™ืœ. ื›ืึธื˜ืฉ ืžื™ืจ ื–ืขื ืขืŸ ืฆื•ืคืจื™ื“ืŸ ืžื™ื˜ ืื•ื ื“ื–ืขืจ ื™ื ืขืจืœืขืš ืึทืคึผื™ืก ื“ื™ืกืงืจื™ื™ื‘ื“ ืื™ืŸ RAML, ื“ื™ ื ื•ื™ื˜ ืฆื• ืึทืจื•ื™ืกื’ืขื‘ืŸ ื“ื™ API ื•ื•ื™ื“ืขืจ ื”ืื˜ ืื•ื™ืคื’ืขื•ื•ืขืงื˜ ื“ื™ ืงืฉื™ื ืคื•ืŸ ื‘ืจื™ืจื”: ื•ื•ืึธืก ืึทื ืึทื˜ื™ื™ืฉืึทืŸ ื ืึธืจืžืึทืœ ืื™ื– ื‘ืขืกื˜ืขืจ ืฆื• ื ื•ืฆืŸ ืคึฟืึทืจ ืื•ื ื“ื–ืขืจ ืึทืจื‘ืขื˜?

ื˜ื›ื™ืœืขืก, ืขืก ื’ืขื•ื•ืขืŸ ืึทื– ืขืก ื–ืขื ืขืŸ ื’ืขื•ื•ืขืŸ ืฆื•ื•ื™ื™ ืกืึทืœื•ืฉืึทื ื– - ื“ื™ ืžืขืจืกื˜ ืคึผืจืึธืกื˜ ื“ื™ื•ื•ืขืœืึทืคึผืžืึทื ืฅ ื–ืขื ืขืŸ RAML ืื•ืŸ Swagger (ืึธื“ืขืจ OAS). ืึธื‘ืขืจ ืื™ืŸ ืคืึทืงื˜ ืขืก ืื™ื– ื’ืขื•ื•ืขืŸ ืึทื– ืขืก ื–ืขื ืขืŸ ืœืคึผื—ื•ืช ื ื™ื˜ 2 ืึทืœื˜ืขืจื ืึทื˜ื™ื•ื•ืขืก, ืึธื‘ืขืจ 3 ืึธื“ืขืจ ืžืขืจ.

ืคึฟื•ืŸ ืื™ื™ืŸ ื–ื™ื™ื˜ ืื™ื– RAML - ืึท ืฉื˜ืึทืจืงืข ืื•ืŸ ืขืคืขืงื˜ื™ื•ื•ืข ืฉืคึผืจืึทืš. ืขืก ื™ืžืคึผืœืึทืžืึทื ืฅ ื›ื™ื™ืขืจืึทืจืงื™ ืื•ืŸ ื™ืจื•ืฉื” ื’ืขื–ื•ื ื˜, ืึทื–ื•ื™ ื“ืขื ืคึฟืึธืจืžืึทื˜ ืื™ื– ืžืขืจ ืคึผืึทืกื™ืง ืคึฟืึทืจ ื’ืจื•ื™ืก ืงืึธืžืคึผืึทื ื™ืขืก ื•ื•ืึธืก ื“ืึทืจืคึฟืŸ ืึท ืคึผืœืึทืฅ ืคื•ืŸ ื“ื™ืกืงืจื™ืคึผืฉืึทื ื– - ื“ืึธืก ืื™ื–, ื ื™ืฉื˜ ืื™ื™ืŸ ืคึผืจืึธื“ื•ืงื˜, ืึธื‘ืขืจ ืคื™ืœืข ืžื™ืงืจืึธ ืกืขืจื•ื•ื™ืกืขืก ื•ื•ืึธืก ื”ืึธื‘ืŸ ืคึผืจืึธืกื˜ ืคึผืึทืจืฅ ืคื•ืŸ ืงืึทื ื˜ืจืึทืงืฅ - ืึธื˜ืขื ื˜ืึทืงื™ื™ืฉืึทืŸ ืกืงื™ืžื–, ื“ื™ ื–ืขืœื‘ืข ื“ืึทื˜ืŸ ื˜ื™ื™ืคึผืก, ื˜ืขื•ืช ืœืœื‘ืขืจ. .

ืื‘ืขืจ ื“ืขืจ ื“ืขื•ื•ืขืœืึธืคึผืขืจ ืคื•ืŸ RAML, Mulesoft, ื”ืื˜ ื–ื™ืš ืื™ื™ื ื’ืขืฉืจื™ื‘ืŸ ื“ื™ Open API ืงืึธื ืกืึธืจื˜ื™ื•ื, ื•ื•ืึธืก ืื™ื– ื“ืขื•ื•ืขืœืึธืคึผื™ื ื’ ืกื•ื•ืึทื’ืขืจ. ื“ืขืจื™ื‘ืขืจ, RAML ืกื•ืกืคึผืขื ื“ืขื“ ื–ื™ื™ึทืŸ ืึทื ื˜ื•ื•ื™ืงืœื•ื ื’. ืฆื• ื™ืžืึทื“ื–ืฉืึทืŸ ื“ืขื ืคึฟืึธืจืžืึทื˜ ืคื•ืŸ ื“ืขืจ ื’ืขืฉืขืขื ื™ืฉ, ื™ืžืึทื“ื–ืฉืึทืŸ ืึทื– ื“ื™ ืžืึทื™ื ื˜ืึทื™ืขืจื– ืคื•ืŸ ื“ื™ ื”ื•ื™ืคึผื˜ ืœื™ื ื•ืงืก ืงืึทืžืคึผืึธื•ื ืึทื ืฅ ืœื™ื ืงืก ืฆื• ืึทืจื‘ืขื˜ืŸ ืื™ืŸ ืžื™ื™ืงืจืึธืกืึธืคึฟื˜. ื“ื™ ืกื™ื˜ื•ืึทืฆื™ืข ืงืจื™ื™ื™ืฅ ื“ื™ ืคึผืจื™ืจืขืงื•ื•ืึทื–ืึทืฅ ืคึฟืึทืจ ื“ื™ ื ื•ืฆืŸ ืคื•ืŸ Swagger, ื•ื•ืึธืก ืื™ื– ื“ื™ื ืึทืžื™ืฉ ื“ืขื•ื•ืขืœืึธืคึผื™ื ื’ ืื•ืŸ ืื™ืŸ ื“ื™ ืœืขืฆื˜ืข - ื“ืจื™ื˜ ื•ื•ืขืจืกื™ืข - ืคึผืจืึทืงื˜ืึทืงืœื™ ื›ืึทืคึผืึทื ื– ืžื™ื˜ RAML ืื™ืŸ ื˜ืขืจืžื™ื ืขืŸ ืคื•ืŸ ื‘ื™ื™ื’ื™ืงื™ื™ึทื˜ ืื•ืŸ ืคืึทื ื’ืงืฉืึทื ืึทืœื™ื˜ื™.

ืื•ื™ื‘ ื ื™ืฉื˜ ืคึฟืึทืจ ืื™ื™ืŸ ื–ืึทืš ...

ื•ื•ื™ ืขืก ื˜ื•ืจื ืก ืื•ื™ืก, ื ื™ื˜ ืึทืœืข ืขืคึฟืขื ืขืŸ ืžืงื•ืจ ื™ื•ื˜ื™ืœืึทื˜ื™ื– ื–ืขื ืขืŸ ื“ืขืจื”ื™ื™ึทื ื˜ื™ืงื˜ ืฆื• OAS 3.0. ืคึฟืึทืจ ืžื™ืงืจืึธ ื‘ืึทื“ื™ื ื•ื ื’ืก ืื™ืŸ Go, ื“ื™ ืžืขืจืกื˜ ืงืจื™ื˜ื™ืฉ ื–ืึทืš ืื™ื– ื“ื™ ืคืขืœืŸ ืคื•ืŸ ืึทื“ืึทืคึผื˜ื™ื™ืฉืึทืŸ ื’ื™ื™ืŸ-ืกื•ื•ืึทื’ืขืจ ืคึฟืึทืจ ื“ื™ ืœืขืฆื˜ืข ื•ื•ืขืจืกื™ืข ืคื•ืŸ โ€‹โ€‹โ€‹โ€‹ื“ืขื ื ืึธืจืžืึทืœ. ืึธื‘ืขืจ, ื“ื™ ื—ื™ืœื•ืง ืฆื•ื•ื™ืฉืŸ Swagger 2 ืื•ืŸ Swagger 3 ืื™ื– ืจื™ื–ื™ืง. ืคึฟืึทืจ ื‘ื™ื™ึทืฉืคึผื™ืœ, ืื™ืŸ ื“ื™ ื“ืจื™ื˜ ื•ื•ืขืจืกื™ืข ื“ื™ ื“ืขื•ื•ืขืœืึธืคึผืขืจืก:

  • ื™ืžืคึผืจื•ื•ื•ื“ ื‘ืึทืฉืจื™ื™ึทื‘ื•ื ื’ ืคื•ืŸ ืึธื˜ืขื ื˜ืึทืงื™ื™ืฉืึทืŸ ืกืงื™ืžื–
  • ื’ืขืขื ื“ื™ืงื˜ JSON ืกื˜ืฉืขืžืึท ืฉื˜ื™ืฆืŸ
  • ืึทืคึผื’ืจื™ื™ื“ื™ื“ ื“ื™ ืคื™ื™ื™ืงื™ื™ื˜ ืฆื• ืœื™ื™ื’ืŸ ื‘ื™ื™ืฉืคื™ืœืŸ

ื“ื™ ืกื™ื˜ื•ืึทืฆื™ืข ืื™ื– ืžืึธื“ื ืข: ื•ื•ืขืŸ ื˜ืฉื•ื–ื™ื ื’ ืึท ื ืึธืจืžืึทืœ, ืื™ืจ ื“ืึทืจืคึฟืŸ ืฆื• ื‘ืึทื˜ืจืึทื›ื˜ืŸ RAML, Swagger 2 ืื•ืŸ Swagger 3 ื•ื•ื™ ื‘ืึทื–ื•ื ื“ืขืจ ืึทืœื˜ืขืจื ืึทื˜ื™ื•ื•ืขืก. ืึธื‘ืขืจ, ื‘ืœื•ื™ื– Swagger 2 ื”ืื˜ ื’ื•ื˜ ืฉื˜ื™ืฆืŸ ืคึฟืึทืจ OpenSource ืžื›ืฉื™ืจื™ื. RAML ืื™ื– ื–ื™ื™ืขืจ ืคืœืขืงืกืึทื‘ืึทืœ ... ืื•ืŸ ืงืึธืžืคึผืœืขืงืก, ืื•ืŸ Swagger 3 ืื™ื– ืฉื•ื•ืึทืš ื’ืขืฉื˜ื™ืฆื˜ ื“ื•ืจืš ื“ื™ ืงื”ืœ, ืึทื–ื•ื™ ืื™ืจ ื•ื•ืขื˜ ื”ืึธื‘ืŸ ืฆื• ื ื•ืฆืŸ ืคึผืจืึทืคึผืจื™ื™ืึทื˜ืขืจื™ ืžื›ืฉื™ืจื™ื ืึธื“ืขืจ ื’ืขืฉืขืคื˜ ืกืึทืœื•ืฉืึทื ื–, ื•ื•ืึธืก ื˜ืขื ื“ ืฆื• ื–ื™ื™ืŸ ื’ืึทื ืฅ ื˜ื™ื™ึทืขืจ.

ื“ืขืจืฆื•, ืื•ื™ื‘ ืขืก ื–ืขื ืขืŸ ืคื™ืœืข ืคื™ื™ึทืŸ ืคึฟืขื™ึดืงื™ื™ื˜ืŸ ืื™ืŸ Swagger, ืึทื–ืึท ื•ื•ื™ ืึท ืคืึทืจื˜ื™ืง ื˜ื•ื™ืขืจ editor.swagger.io, ืื•ื™ืฃ ื•ื•ืึธืก ืื™ืจ ืงืขื ืขืŸ ืฆื•ืคึฟืขืœื™ืงืขืจ ืึทืŸ ืึทื ืึธื˜ืึทืฆื™ืข ืื•ืŸ ื‘ืึทืงื•ืžืขืŸ ื•ื•ื™ื–ืฉื•ื•ืึทืœืึทื–ื™ื™ืฉืึทืŸ ืžื™ื˜ ืึท ื“ื™ื˜ื™ื™ืœื“ ื‘ืึทืฉืจื™ื™ึทื‘ื•ื ื’, ืœื™ื ืงืก ืื•ืŸ ืงืึทื ืขืงืฉืึทื ื–, ื“ืขืžืึธืœื˜ ืคึฟืึทืจ ื“ื™ ืžืขืจ ืคื•ื ื“ืึทืžืขื ื˜ืึทืœ ืื•ืŸ ื•ื•ื™ื™ื ื™ืงืขืจ ืคืจื™ื™ึทื ื“ืœืขืš RAML ืขืก ืื™ื– ื ื™ื˜ ืึทื–ืึท ื’ืขืœืขื’ื ื”ื™ื™ื˜. ื™ืึธ, ืื™ืจ ืงืขื ืขืŸ ื–ื•ื›ืŸ ืคึฟืึทืจ ืขืคึผืขืก ืฆื•ื•ื™ืฉืŸ ืคึผืจืึทื“ื–ืฉืขืงืก ืื•ื™ืฃ GitHub, ื’ืขืคึฟื™ื ืขืŸ ืึทืŸ ืึทื ืึทืœืึธื’ ื“ืึธืจื˜ ืื•ืŸ ืฆืขื•ื•ื™ืงืœืขืŸ ืขืก ื–ื™ืš. ืึธื‘ืขืจ, ืื™ืŸ ืงื™ื™ืŸ ืคืึทืœ, ืขืžืขืฆืขืจ ื•ื•ืขื˜ ื”ืึธื‘ืŸ ืฆื• ื˜ื™ื™ึทื ืขืŸ ื“ืขื ื˜ื•ื™ืขืจ, ื•ื•ืึธืก ืื™ื– ื ื™ืฉื˜ ืึทื–ื•ื™ ื‘ืึทืงื•ื•ืขื ืคึฟืึทืจ ื™ืงืขืจื“ื™ืง ื ื•ืฆืŸ ืึธื“ืขืจ ื˜ืขืกื˜ื™ื ื’ ื“ืึทืจืฃ. ืื™ืŸ ืึทื“ื™ืฉืึทืŸ, ืกื•ื•ืึทื’ืขืจ ืื™ื– ืžืขืจ "ื•ื ืคึผืจื™ื ืกื™ืคึผืœืขื“", ืึธื“ืขืจ ืžืขืจ ืœื™ื‘ืขืจืึทืœ - ืขืก ืงืขื ืขืŸ ื–ื™ื™ืŸ ื“ื–ืฉืขื ืขืจื™ื™ื˜ืึทื“ ืคึฟื•ืŸ ื‘ืึทืžืขืจืงื•ื ื’ืขืŸ ืื™ืŸ ื“ื™ ืงืึธื“, ื•ื•ืึธืก, ืคื•ืŸ ืงื•ืจืก, ื’ื™ื™ื˜ ืงืขื’ืŸ ื“ื™ API ืขืจืฉื˜ืขืจ ืคึผืจื™ื ืฆื™ืคึผ ืื•ืŸ ืื™ื– ื ื™ืฉื˜ ื’ืขืฉื˜ื™ืฆื˜ ื“ื•ืจืš ืงื™ื™ืŸ ืคื•ืŸ ื“ื™ RAML ื™ื•ื˜ื™ืœืึทื˜ื™ื–.

ืืžืืœ ื”ืื‘ืŸ ืžื™ืจ ืื ื’ืขื”ื•ื™ื‘ืŸ ืืจื‘ืขื˜ืŸ ืžื™ื˜ ืจืžืœ ืืœืก ื ืคืœืขืงืกื™ืงืขืจ ืฉืคืจืืš, ืื•ืŸ ื“ืขืจืคืืจ ื”ืื‘ืŸ ืžื™ืจ ื–ื™ืš ื’ืขืžื•ื–ื˜ ื˜ืืŸ ืืกืืš ื–ืื›ืŸ. ืคึฟืึทืจ ื‘ื™ื™ึทืฉืคึผื™ืœ, ืื™ื™ื ืขืจ ืคื•ืŸ ื“ื™ ืคึผืจืึทื“ื–ืฉืขืงืก ื ื™ืฆื˜ ื“ื™ ื ื•ืฆืŸ ืจืึทืคืœื™ืงืึทื˜ื™ืึธื ืก ืื™ืŸ ืึทืคึผืึทืจืึทื˜ ื˜ืขืกืฅ, ื•ื•ืึธืก ืฉื˜ื™ืฆื˜ ื‘ืœื•ื™ื– RAML 0.8. ืึทื–ื•ื™ ืžื™ืจ ื”ืึธื‘ืŸ ืฆื• ืœื™ื™ื’ืŸ ืงืจืึทื˜ืฉื™ื– ืึทื–ื•ื™ ืึทื– ื“ื™ ื ื•ืฆืŸ ืงืขืŸ "ืขืกืŸ" RAML ื•ื•ืขืจืกื™ืข 1.0.

ืฆื™ ืื™ืจ ื“ืึทืจืคึฟืŸ ืฆื• ืงืœื™ื™ึทื‘ืŸ?

ื ืึธืš ืืจื‘ืขื˜ืŸ ืื•ื™ืฃ ื“ื™ ืงืึทืžืคึผืœื™ื˜ื™ื ื’ ื“ื™ ื™ืงืึธื•ืกื™ืกื˜ืึทื ืคื•ืŸ ืกืึทืœื•ืฉืึทื ื– ืคึฟืึทืจ RAML, ืžื™ืจ ื’ืขืงื•ืžืขืŸ ืฆื• ื“ืขืจ ืžืกืงื ื ืึทื– ืžื™ืจ ื“ืึทืจืคึฟืŸ ืฆื• ื’ืขืจ RAML ืื™ืŸ Swagger 2 ืื•ืŸ ื“ื•ืจื›ืคื™ืจืŸ ืึทืœืข ื“ื™ ืึธื˜ืึทืžื™ื™ืฉืึทืŸ, ื•ื•ืขืจืึทืคืึทืงื™ื™ืฉืึทืŸ, ื˜ืขืกื˜ื™ื ื’ ืื•ืŸ ืกืึทื‘ืกืึทืงื•ื•ืึทื ื˜ ืึทืคึผื˜ืึทืžืึทื–ื™ื™ืฉืึทืŸ ืื™ืŸ ืขืก. ื“ืึธืก ืื™ื– ืึท ื’ื•ื˜ืข ื•ื•ืขื’ ืฆื• ืœื™ื•ื•ืขืจื™ื“ื–ืฉ ื‘ื™ื™ื“ืข ื“ื™ ื‘ื™ื™ื’ื™ืงื™ื™ื˜ ืคื•ืŸ RAML ืื•ืŸ ื“ื™ ืกื•ื•ืึทื’ืขืจ ืฉื˜ื™ืฆืŸ ืคึฟืึทืจ ืงื”ืœ ืžื›ืฉื™ืจื™ื.

ืฆื• ืกืึธืœื•ื•ืข ื“ืขื ืคึผืจืึธื‘ืœืขื, ืขืก ื–ืขื ืขืŸ ืฆื•ื•ื™ื™ OpenSource ืžื›ืฉื™ืจื™ื ื•ื•ืึธืก ื–ืึธืœ ืฆื•ืฉื˜ืขืœืŸ ืงืึธื ื˜ืจืึทืงื˜ ืงืึทื ื•ื•ืขืจื–ืฉืึทืŸ:

  1. ืึธืึทืก-ืจืึทืžืœ-ืงืึทื ื•ื•ืขืจื˜ืขืจ ืื™ื– ืึท ื“ืขืจื•ื•ื™ื™ึทืœ ืึทื ืกืึทืคึผืึธืจื˜ื™ื“ ื ื•ืฆืŸ. ื‘ืฉืขืช ืืจื‘ืขื˜ืŸ ืžื™ื˜ ืื™ื, ืžื™ืจ ื“ื™ืกืงืึทื•ื•ืขืจื“ ืึทื– ืขืก ื”ืื˜ ืึท ื ื•ืžืขืจ ืคื•ืŸ ืคึผืจืึธื‘ืœืขืžืก ืžื™ื˜ ืงืึธืžืคึผืœืขืงืก RAMLs ื•ื•ืึธืก ื–ืขื ืขืŸ "ืคืึทืจืฉืคึผืจื™ื™ื˜ืŸ" ืื™ื‘ืขืจ ืึท ื’ืจื•ื™ืก ื ื•ืžืขืจ ืคื•ืŸ ื˜ืขืงืขืก. ื“ืขืจ ืคึผืจืึธื’ืจืึทื ืื™ื– ื’ืขืฉืจื™ื‘ืŸ ืื™ืŸ ื“ื–ืฉืึทื•ื•ืึทืกืงืจื™ืคึผื˜ ืื•ืŸ ืคึผืขืจืคืึธืจืžื– ืึท ืจืขืงื•ืจืกื™ื•ื•ืข ื˜ืจืึทื•ื•ืขืจืกืึทืœ ืคื•ืŸ ืึท ืกื™ื ื˜ืึทืงืก ื‘ื•ื™ื. ืจืขื›ื˜ ืฆื• ื“ื™ื ืึทืžื™ืฉ ื˜ื™ื™ืคึผื™ื ื’, ืขืก ื•ื•ืขืจื˜ ืฉื•ื•ืขืจ ืฆื• ืคึฟืึทืจืฉื˜ื™ื™ืŸ ื“ืขื ืงืึธื“, ืึทื–ื•ื™ ืžื™ืจ ื‘ืึทืฉืœืึธืกืŸ ื ื™ืฉื˜ ืฆื• ื•ื•ื™ืกื˜ ืฆื™ื™ื˜ ืฆื• ืฉืจื™ื™ึทื‘ืŸ ืคึผืึทื˜ืฉืึทื– ืคึฟืึทืจ ืึท ืฉืขื“ืœืขืš ื ื•ืฆืŸ.
  2. ื•ื•ืขื‘ืึทืคึผื™-ืคึผืึทืกืขืจ - ืึท ื’ืขืฆื™ื™ึทื’ ืคื•ืŸ ื“ืขืจ ื–ืขืœื‘ื™ืงืขืจ ืคื™ืจืžืข ื•ื•ืึธืก ืงืœื™ื™ืžื– ืฆื• ื–ื™ื™ืŸ ื’ืจื™ื™ื˜ ืฆื• ื‘ื™ื™ึทื˜ืŸ ืึทืœืฅ ืื•ืŸ ืึทืœืฅ ืื•ืŸ ืื™ืŸ ืงื™ื™ืŸ ืจื™ื›ื˜ื•ื ื’. ื‘ื™ื– ืื™ืฆื˜, ืฉื˜ื™ืฆืŸ ืื™ื– ืึทื ืึทื•ื ืกื˜ ืคึฟืึทืจ RAML 0.8, RAML 1.0 ืื•ืŸ Swagger 2.0. ืึธื‘ืขืจ, ืื™ืŸ ื“ืขืจ ืฆื™ื™ื˜ ืคื•ืŸ ืื•ื ื“ื–ืขืจ ืคืึธืจืฉื•ื ื’, ื“ื™ ื ื•ืฆืŸ ืื™ื– ื ืึธืš ื’ืึธืจ ืคื™ื™ึทื›ื˜ ืื•ืŸ ืึทื ื™ื•ื–ืึทื‘ืึทืœ. ื“ืขื•ื•ืขืœืึธืคึผืขืจืก ืžืึทื›ืŸ ืึท ืžื™ืŸ ืคื•ืŸ IR, ืึทืœืึทื•ื™ื ื’ ื–ื™ื™ ืฆื• ื’ืขืฉื•ื•ื™ื ื“ ืœื™ื™ื’ืŸ ื ื™ื™ึท ืกื˜ืึทื ื“ืึทืจื“ืก ืื™ืŸ ื“ืขืจ ืฆื•ืงื•ื ืคึฟื˜. ืื‘ืขืจ ื‘ื™ื– ืื™ืฆื˜ ืขืก ื ืึธืจ ื˜ื•ื˜ ื ื™ืฉื˜ ืึทืจื‘ืขื˜ืŸ.

ืื•ืŸ ื“ืึธืก ืื™ื– ื ื™ืฉื˜ ืึทืœืข ื“ื™ ืฉื•ื•ืขืจื™ืงื™ื™ื˜ืŸ ื•ื•ืึธืก ืžื™ืจ ื”ืึธื‘ืŸ ื’ืขืคึผืœืึธื ื˜ืขืจื˜. ืื™ื™ื ืขืจ ืคื•ืŸ ื“ื™ ืกื˜ืขืคึผืก ืื™ืŸ ืื•ื ื“ื–ืขืจ ืจืขืจื  - ืœื™ื ื™ืข ืื™ื– ืฆื• ื‘ืึทืฉื˜ืขื˜ื™ืงืŸ ืึทื– ื“ื™ RAML ืคึฟื•ืŸ ื“ื™ ืจื™ืคึผืึทื–ืึทื˜ืึธืจื™ ืื™ื– ืจื™ื›ื˜ื™ืง ืงืึธืจืขื•ื• ืฆื• ื“ื™ ื‘ืึทืฉืจื™ื™ึทื‘ื•ื ื’. ืžื™ืจ ื’ืขืคืจื•ื•ื•ื˜ ืขื˜ืœืขื›ืข ื™ื•ื˜ื™ืœืึทื˜ื™ื–. ืื™ื‘ืขืจืจืึทืฉื ื“ื™ืง, ื”ืึธื‘ืŸ ื–ื™ื™ ืึทืœืข ื’ืขืฉื•ื•ืึธืจืŸ ืื•ื ื“ื–ืขืจ ืึทื ืึธื˜ืึทืฆื™ืขืก ืื™ืŸ ืคืึทืจืฉื™ื“ืขื ืข ืขืจื˜ืขืจ ืื•ืŸ ืžื™ื˜ ื’ืึธืจ ืคืึทืจืฉื™ื“ืขื ืข ืฉืœืขื›ื˜ ื•ื•ืขืจื˜ืขืจ. ืื•ืŸ ื ื™ื˜ ืฉื˜ืขื ื“ื™ืง ืฆื• ื“ื™ ืคื•ื ื˜ :).

ืื™ืŸ ื“ื™ ืกื•ืฃ, ืžื™ืจ ื’ืขื–ืขืฆื˜ ืื•ื™ืฃ ืึท ืื™ืฆื˜ ืึทื•ื˜ื“ื™ื™ื˜ื™ื“ ืคึผืจื•ื™ืขืงื˜, ื•ื•ืึธืก ืื•ื™ืš ื”ืื˜ ืึท ื ื•ืžืขืจ ืคื•ืŸ ืคืจืื‘ืœืขืžืขืŸ (ืžืืœ ืขืก ืงืจืึทืฉื™ื– ืื•ื™ืก ืคื•ืŸ ื“ื™ ื‘ืœื•ื™, ื”ืื˜ ืคึผืจืึธื‘ืœืขืžืก ื•ื•ืขืŸ ืืจื‘ืขื˜ืŸ ืžื™ื˜ ืจืขื’ื•ืœืขืจ ืื•ื™ืกื“ืจื•ืงืŸ). ืื–ื•ื™, ืžื™ืจ ื”ืึธื‘ืŸ ื ื™ืฉื˜ ื’ืขืคึฟื™ื ืขืŸ ืึท ื•ื•ืขื’ ืฆื• ืกืึธืœื•ื•ืข ื“ื™ ืคึผืจืึธื‘ืœืขืžืก ืคื•ืŸ ื•ื•ืึทืœืึทื“ื™ื™ืฉืึทืŸ ืื•ืŸ ืงืึทื ื•ื•ืขืจื–ืฉืึทืŸ ื‘ืื–ื™ืจื˜ ืื•ื™ืฃ ืคืจื™ื™ ืžื›ืฉื™ืจื™ื, ืื•ืŸ ื‘ืึทืฉืœืึธืกืŸ ืฆื• ื ื•ืฆืŸ ืึท ื’ืขืฉืขืคื˜ ื ื•ืฆืŸ. ืื™ืŸ ื“ืขืจ ืฆื•ืงื•ื ืคึฟื˜, ื•ื•ื™ OpenSource ืžื›ืฉื™ืจื™ื ื•ื•ืขืจืŸ ืžืขืจ ื“ืขืจื•ื•ืึทืงืกืŸ, ื“ืขื ืคึผืจืึธื‘ืœืขื ืงืขืŸ ื–ื™ื™ืŸ ื’ืจื™ื ื’ืขืจ ืฆื• ืกืึธืœื•ื•ืข. ืื™ืŸ ื“ืขืจ ื“ืขืจื•ื•ื™ื™ืœ, ื“ื™ ืึทืจื‘ืขื˜ ืื•ืŸ ืฆื™ื™ื˜ ืงืึธืก ืคึฟืึทืจ "ืคื™ื ื™ืฉื™ื ื’" ื’ืขื•ื•ืขืŸ ืฆื• ืื•ื ื“ื– ืžืขืจ ื‘ืึทื˜ื™ื™ึทื˜ื™ืง ื•ื•ื™ ื“ื™ ืคึผืจื™ื™ึทื– ืคื•ืŸ ืึท ื’ืขืฉืขืคื˜ ื“ื™ื ืกื˜.

ืกืึธืฃ

ื ืึธืš ืึทืœืข ื“ืขื, ืžื™ืจ ื’ืขื•ื•ืืœื˜ ืฆื• ื˜ื™ื™ืœืŸ ืื•ื ื“ื–ืขืจ ื“ืขืจืคืึทืจื•ื ื’ ืื•ืŸ ื˜ืึธืŸ ืึทื– ืื™ื™ื“ืขืจ ื˜ืฉื•ื–ื™ื ื’ ืึท ื’ืขืฆื™ื™ึทื’ ืคึฟืึทืจ ื“ื™ืกืงืจื™ื™ื‘ื™ื ื’ ืงืึทื ื˜ืจืึทืงืฅ, ืื™ืจ ื“ืึทืจืคึฟืŸ ืฆื• ืงืœืืจ ื“ืขืคื™ื ื™ืจืŸ ื•ื•ืึธืก ืื™ืจ ื•ื•ื™ืœืŸ ืคื•ืŸ ืื™ื ืื•ืŸ ื•ื•ืึธืก ื‘ื•ื“ื–ืฉืขื˜ ืื™ืจ ื–ืขื ื˜ ื’ืจื™ื™ื˜ ืฆื• ื™ื ื•ื•ืขืกื˜ื™ืจืŸ. ืื•ื™ื‘ ืžื™ืจ ืคืึทืจื’ืขืกืŸ ื•ื•ืขื’ืŸ OpenSource, ืขืก ื–ืขื ืขืŸ ืฉื•ื™ืŸ ืึท ื’ืจื•ื™ืก ื ื•ืžืขืจ ืคื•ืŸ ื‘ืึทื“ื™ื ื•ื ื’ืก ืื•ืŸ ืคึผืจืึธื“ื•ืงื˜ืŸ ื•ื•ืึธืก ื•ื•ืขื˜ ื”ืขืœืคึฟืŸ ืื™ืจ ืงืึธื ื˜ืจืึธืœื™ืจืŸ, ื’ืขืจ ืื•ืŸ ื•ื•ืึทืœืึทื“ื™ื™ื˜. ืื‘ืขืจ ื–ื™ื™ ื–ืขื ืขืŸ ื˜ื™ื™ึทืขืจ, ืื•ืŸ ืžืืœ ื–ื™ื™ืขืจ ื˜ื™ื™ึทืขืจ. ืคึฟืึทืจ ืึท ื’ืจื•ื™ืก ืคื™ืจืžืข, ืึทื–ืึท ืงืึธืก ื–ืขื ืขืŸ ื˜ืึธืœืขืจืึทื‘ืœืข, ืึธื‘ืขืจ ืคึฟืึทืจ ืึท ืกื˜ืึทืจื˜ืึทืคึผ ื–ื™ื™ ืงืขื ืขืŸ ื•ื•ืขืจืŸ ืึท ื’ืจื•ื™ืก ืžืึทืกืข.

ื‘ืึทืฉื˜ื™ืžืขืŸ ื“ื™ ื’ืึทื ื’ ืคื•ืŸ ืžื›ืฉื™ืจื™ื ื•ื•ืึธืก ืื™ืจ ื•ื•ืขื˜ ื ื•ืฆืŸ ืฉืคึผืขื˜ืขืจ. ืคึฟืึทืจ ื‘ื™ื™ึทืฉืคึผื™ืœ, ืื•ื™ื‘ ืื™ืจ ื ืึธืจ ื“ืึทืจืคึฟืŸ ืฆื• ื•ื•ื™ื™ึทื–ืŸ ืึท ืงืึธื ื˜ืจืึทืงื˜, ืขืก ื•ื•ืขื˜ ื–ื™ื™ืŸ ื’ืจื™ื ื’ืขืจ ืฆื• ื ื•ืฆืŸ Swagger 2, ื•ื•ืึธืก ื”ืื˜ ืึท ืฉื™ื™ืŸ ืึทืคึผื™, ื•ื•ื™ื™ึทืœ ืื™ืŸ RAML ืื™ืจ ื•ื•ืขื˜ ื”ืึธื‘ืŸ ืฆื• ื‘ื•ื™ืขืŸ ืื•ืŸ ื˜ื™ื™ึทื ืขืŸ ื“ื™ ื“ื™ื ืกื˜ ื–ื™ืš.
ื“ื™ ืžืขืจ ื˜ืึทืกืงืก ืื™ืจ ื”ืึธื‘ืŸ, ื“ื™ ืžืขืจ ื“ื™ ื ื•ื™ื˜ ืคึฟืึทืจ ืžื›ืฉื™ืจื™ื ื•ื•ืขื˜ ื–ื™ื™ืŸ, ืื•ืŸ ื–ื™ื™ ื–ืขื ืขืŸ ืึทื ื“ืขืจืฉ ืคึฟืึทืจ ืคืึทืจืฉื™ื“ืขื ืข ืคึผืœืึทื˜ืคืึธืจืžืก, ืื•ืŸ ืขืก ืื™ื– ื‘ืขืกืขืจ ืฆื• ืžื™ื“ ื‘ืืงืขื ืขืŸ ื–ื™ืš ืžื™ื˜ ื“ื™ ื‘ื ื™ืžืฆื ื•ื•ืขืจืกื™ืขืก ืฆื• ืžืึทื›ืŸ ืึท ื‘ืจื™ืจื” ื•ื•ืึธืก ืžื™ื ืึทืžื™ื™ื– ื“ื™ื™ืŸ ืงืึธืก ืื™ืŸ ื“ืขืจ ืฆื•ืงื•ื ืคึฟื˜.

ืื‘ืขืจ ืขืก ืื™ื– ื•ื•ืขืจื˜ ืฆื• ื“ืขืจืงืขื ืขืŸ ืึทื– ืึทืœืข ื™ืงืึธื•ืกื™ืกื˜ืึทืžื– ื•ื•ืึธืก ืขืงืกื™ืกื˜ื™ืจืŸ ื”ื™ื™ึทื ื˜ ื–ืขื ืขืŸ ื™ืžืคึผืขืจืคื™ืงื˜. ื“ืขืจื™ื‘ืขืจ, ืื•ื™ื‘ ืขืก ื–ืขื ืขืŸ ืคืึทื ืก ืื™ืŸ ื“ืขืจ ืคื™ืจืžืข ื•ื•ืึธืก ื•ื•ื™ ืฆื• ืึทืจื‘ืขื˜ืŸ ืื™ืŸ RAML ื•ื•ื™ื™ึทืœ "ืขืก ืึทืœืึทื•ื– ืื™ืจ ืฆื• ืื•ื™ืกื“ืจื™ืงืŸ ื’ืขื“ืื ืงืขืŸ ืžืขืจ ืคืœืขืงืกืึทื‘ืึทืœ," ืึธื“ืขืจ, ืื•ื™ืฃ ื“ื™ ืคืึทืจืงืขืจื˜, ื‘ืขืกืขืจ ื•ื•ืขืœืŸ ืกื•ื•ืึทื’ืขืจ ื•ื•ื™ื™ึทืœ "ืขืก ืื™ื– ืงืœืึธืจ," ืขืก ืื™ื– ื‘ืขืกื˜ืขืจ ืฆื• ืœืึธื–ืŸ ื–ื™ื™ ืฆื• ืึทืจื‘ืขื˜ืŸ ืื™ืŸ ื•ื•ืึธืก ื–ื™ื™ ื–ืขื ืขืŸ ื–ื™ื™ ื–ืขื ืขืŸ ื’ืขื•ื•ื™ื™ื ื˜ ืฆื• ืขืก ืื•ืŸ ื•ื•ื™ืœืŸ ืขืก, ื•ื•ื™ื™ึทืœ ื“ื™ ืžื›ืฉื™ืจื™ื ืคื•ืŸ ืงื™ื™ืŸ ืคื•ืŸ ื“ื™ ืคึฟืึธืจืžืึทื˜ื™ืจื•ื ื’ืขืŸ ื“ืึทืจืคืŸ ืžืึธื“ื™ืคื™ืงืึทื˜ื™ืึธืŸ ืžื™ื˜ ืึท ื˜ืขืงืข.

ื•ื•ื™ ืคึฟืึทืจ ืื•ื ื“ื–ืขืจ ื“ืขืจืคืึทืจื•ื ื’, ืื™ืŸ ื“ื™ ืคืืœื’ืขื ื“ืข ืึทืจื˜ื™ืงืœืขืŸ ืžื™ืจ ื•ื•ืขืœืŸ ืจืขื“ืŸ ื•ื•ืขื’ืŸ ื•ื•ืึธืก ืกื˜ืึทื˜ื™ืง ืื•ืŸ ื“ื™ื ืึทืžื™ืฉ ื˜ืฉืขืงืก ืžื™ืจ ื“ื•ืจื›ืคื™ืจืŸ ื‘ืื–ื™ืจื˜ ืื•ื™ืฃ ืื•ื ื“ื–ืขืจ RAML-Swagger ืึทืจืงืึทื˜ืขืงื˜ืฉืขืจ, ื•ื•ื™ ื’ืขื–ื•ื ื˜ ื•ื•ื™ ื•ื•ืึธืก ื“ืึทืงื™ื•ืžืขื ื˜ื™ื™ืฉืึทืŸ ืžื™ืจ ื“ื–ืฉืขื ืขืจื™ื™ื˜ ืคึฟื•ืŸ ืงืึทื ื˜ืจืึทืงืฅ ืื•ืŸ ื•ื•ื™ ื“ืึธืก ืึทืœืข ืึทืจื‘ืขื˜.

ื‘ืœื•ื™ื– ืจืขื’ื™ืกื˜ืจื™ืจื˜ ื ื™ืฆืขืจืก ืงืขื ืขืŸ ืึธื ื˜ื™ื™ืœ ื ืขืžืขืŸ ืื™ืŸ ื“ื™ ื™ื‘ืขืจื‘ืœื™ืง. ืกื™ื™ืŸ ืืจื™ื™ืŸื‘ื™ื˜ืข.

ื•ื•ืึธืก ืฉืคึผืจืึทืš ื˜ืึธืŸ ืื™ืจ ื ื•ืฆืŸ ืฆื• ืึทื ืึทื˜ื™ื™ื˜ ืžื™ืงืจืึธืกืขืจื•ื•ื™ืก ืงืึทื ื˜ืจืึทืงืฅ?

  • RAML 0.8

  • RAML 1.0

  • ืฉื•ื•ืื’ืขืจ 2

  • OAS3 (ืึทืงืึท)

  • ืคึผืœืึทืŸ

  • ืื ื“ืขืจืข

  • ื ื™ื˜ ื ื™ืฆืŸ

100 ื‘ืื ื•ืฆืขืจ ื”ืื‘ืŸ ื’ืขืฉื˜ื™ืžื˜. 24 ื‘ืื ื•ืฆืขืจ ื”ืื‘ืŸ ื–ื™ืš ืืคื’ืขื”ืืœื˜ืŸ.

ืžืงื•ืจ: www.habr.com

ืœื™ื™ื’ืŸ ืึท ื‘ืึทืžืขืจืงื•ื ื’