Designing Rest with Raml Part-2

Transcript

1. DESIGNING REST APIS WITH RAML-2 SIVA K CERTIFIED MULESOFT DEVELOPER
2. HOW CAN WE DESIGN RAML FOR OUR RESTAPIS WITH POST ???
3. WE WILL GO BACK TO OUR API DESIGNER WHERE WE DESIGNED OUR PREVIOUS API AND START WITH A NEW RESOURCE AND NEW METHODS
9. NOW WE CAN ADD METHODS FOR OUR RESOURCES. METHODS :- METHODS ARE OPERATIONS THAT ARE PERFORMED ON A RESOURCE. THERE CAN BE SEVERAL METHODS APPLIED ON A RESOURCES SUCH AS :- * GET * POST * PUT * DELETE AND MANY MORE. WE WILL BE SEEING GET PERFORMED ON OUR RESOURCE. METHODS ALSO CONTAINS THE PROPERTIES LIKE DISPLAY NAME AND DESCRIPTION
11. AS YOU CAN SEE HERE, WE APPLIED POST METHOD ON OUR RESOURCE /BOOK
12. HERE WE CAN SEE THAT THE POST METHOD TAKES INPUT IN THE BODY SECTION. WE CAN REFER THE BODY INPUT WITH SCHEMA OR WITH EXAMPLE OR WITH BOTH. OTHER PROPERTIES OF FORMPARAMETER ARE DESCRIPTION, TYPE, REQUIRED, PATTERN AND EXAMPLE. SO, HERE IN OUR RESOURCE /BOOK, WE CAN ACCESS IT USING IT AS A SUB URL /BOOK OR CAN ADD THE OPTIONAL URI PARAM NAME SUCH AS /BOOK/{NAME}
14. WE CAN DIFFERENT RESPONSE BASED ON STATUS CODE :
15. RESPONSES :- A RESOURCE METHODS MAY HAVE ONE OR MORE RESPONSES. RESPONSES MAY BE DESCRIBED USING THE DESCRIPTION PROPERTY, AND MAY INCLUDE EXAMPLE ATTRIBUTES OR SCHEMA PROPERTIES. RESPONSES MUST BE A MAP OF ONE OR MORE HTTP STATUS CODES, WHERE EACH STATUS CODE ITSELF IS A MAP THAT DESCRIBES THAT STATUS CODE. IN OUR EXAMPLE, WE HAVE MAPPED 2 RESPONSES FOR STATUS CODE 200 AND 404 RESPECTIVELY. SO, THESE RESPONSE WILL BE GENERATED AS PER THE STATUS CODE.
16. WE CAN SEE AT RIGHT SIDE OF OUR API DESIGNER, WHERE PREVIEW OF OUR API IS DISPLAYED AND THE PREVIEW GETS UPDATED EVERYTIME WE CHANGE OR UPDATE OUR CODE. HERE WE CAN SEE THE DESCRIPTION, STRUCTURE OF OUR API AND ALSO THE DESCRIPTION OF ELEMENTS WE HAVE PROVIDED.
18. API DESIGNER PLATFORM PROVIDES AN OPTION TO TEST OUR APIS THAT WE BUILD IN IT. IN THE LEFT SIDE WE CAN SEE A BUTTON CALLED MOCKING SERVICE, IF WE ON THAT BUTTON, THE API WILL BE READY FOR A MOCK TEST. YOU CAN SEE IN THE CODE, THAT OUR BASEURI HAS BEEN COMMENTED AND A NEW MOCK URI IS GENERATED.
19. SO, TO TEST THE API, WE NEED TO HIT TRY IT BUTTON IN THE RIGHT SIDE, THAT DISPLAY OUR API GRAPHICALLY .:-
20. AFTER HITTING TRY IT BUTTON WE CAN SEE PROTOCOLS, URI PARAM FIELD THAT WE NEED TO FILL BEFORE WE HIT THE SERVICE. WE CAN SEE IT IS ALREADY FILLED WITH EXAMPLE VALUES.
21. WE NEED TO HIT THE POST BUTTON TO HIT THE SERVICE THAT IS DESIGNED WITH POST METHOD, BUT BEFORE THAT WE NEED TO FILL THE BODY WITH EXAMPLE REQUEST:-
22. AFTER WE HIT THE POST BUTTON, WE CAN SEE THAT THE RESPONSE IS GENERATED WITH STATUS CODE 200
23. WE CAN CLICK THE SAVE BUTTON AND SAVE OUR API DESIGN IN API DESIGNER.
24. CONCLUSION…..
25. SO WE CAN SEE IT IS VERY VERY EASY TO DESIGN AND CREATE A RAML FILE FOR OUR RESTFUL API.THE API DESIGNER HELPS US GREATLY IN DESIGNING AS WELL AS TESTING THE API WE CREATE. IN THIS WE HAVE SEEN HOW TO DESIGN A REST API WITH POST METHOD A URI PARAMETER. SO AT THE END I CAN ONLY SAY THAT, LET’S SPREAD OUR KNOWLEDGE AND EXPAND OUR MULE COMMUNITY. 