Skip to Content

Changes for page HTTP Resources

Last modified by Erik Bakker on 2024/08/23 10:51
From version 22.1
edited by Danniar Firdausy
on 2024/08/21 10:25
Change comment: There is no comment for this version
To version 7.1
edited by Eva Torken
on 2023/04/20 11:33
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.dfirdausy
1 +XWiki.etorken
Content
... ... @@ -1,7 +1,8 @@
1 1  {{container}}{{container layoutStyle="columns"}}(((
2 -In this microlearning, we will dive into the essentials of HTTP Resource Paths. A crucial part of setting up your API Gateway with the help of RESTful services is knowing to which resources (e.g., Order, Client, Employee) you want to give external parties access to your business processes via your API Gateway. Let us explore the best practices and foundational concepts to effectively set up your API Gateway.
2 +In this microlearning, we will focus on learning about HTTP Resource (Paths).
3 +A crucial part of setting up your (API) Gateway with the help of RESTful services is knowing to which resources (i.e. Order, Client, Employee) you want to give external parties access via your (API) Gateway.
3 3  
4 -If you have any questions along the way, feel free to reach out to us at [[academy@emagiz.com>>mailto:academy@emagiz.com]].
5 +Should you have any questions, please contact [[academy@emagiz.com>>mailto:academy@emagiz.com]].
5 5  
6 6  == 1. Prerequisites ==
7 7  
... ... @@ -10,7 +10,7 @@
10 10  == 2. Key concepts ==
11 11  
12 12  This microlearning centers around HTTP Resource (Paths) in conjunction with the API Gateway solution of eMagiz.
13 -With HTTP Resource Paths we mean: Identify the resource (e.g., Client, Order, Employee) and define the descriptive path (i.e., {{code language=text}}/v1/order{{/code}}, {{code language=text}}/v1/order/{uuid}{{/code}}) an external party can call to execute the operation.
14 +With HTTP Resource Paths we mean: Identify the resource (i.e. Client, Order, Employee) and define the descriptive path (i.e. /v1/order, /v1/order/{uuid}) an external party can call to execute the operation.
14 14  With API Gateway we mean: A collection of RESTful API operations that can be published to the outside world to give them access to applications that are linked to your business process.
15 15  
16 16  When determining the correct resource path to expose to the outside world start at what you want to make publicly available.
... ... @@ -23,7 +23,8 @@
23 23  * /order-management/orders
24 24  * /order-management/trips
25 25  
26 -To determine the correct notation also take into account how the backend system that you want to expose via the API Gateway has determined their HTTP Resource (Paths). If this adheres to the best practice simply use that. More on that specific relation in later microlearnings.
27 +To determine the correct notation also take into account how the backend system that you want to expose via the API Gateway has determined their HTTP Resource (Paths).
28 +If this adheres to the best practice simply use that. More on that specific relation in later microlearnings.
27 27  
28 28  A list of best practices can be found here:
29 29  [[REST API naming concepts>>https://restfulapi.net/resource-naming/||target="blank"]]
... ... @@ -51,20 +51,23 @@
51 51  In the following microlearning on HTTP Operations, we will bring the HTTP Resource (Paths) together with the HTTP Operations.
52 52  That combination is the basis for any integration that runs via the API Gateway.
53 53  
54 -== 4. Key takeaways ==
56 +== 4. Assignment ==
55 55  
58 +Read up on the best practices when it comes to the naming of HTTP Resource Paths and see if you can relate this to the eMagiz implementation.
59 +This assignment can be completed with the help of the (Academy) project that you have created/used in the previous assignment.
60 +
61 +== 5. Key takeaways ==
62 +
56 56  * Start at the backend operation
57 57  * Determine usability of what is provided to you
58 58  * Take action based on that analysis
59 59  
60 -== 5. Suggested Additional Readings ==
67 +== 6. Suggested Additional Readings ==
61 61  
62 62  If you are interested in this topic and want more information on it please read the help text provided by eMagiz and read the following links:
63 63  
64 -* [[REST API naming concepts (External)>>https://restfulapi.net/resource-naming/||target="blank"]]
65 -* [[Crash Course (Menu)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.WebHome||target="blank"]]
66 -** [[Crash Course API Gateway (Navigation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course API Gateway.WebHome||target="blank"]]
67 -*** [[Swagger UI (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course API Gateway.crashcourse-api-gateway-swagger-ui||target="blank"]]
68 -*** [[HTTP Operations (Explanation)>>doc:Main.eMagiz Academy.Microlearnings.Crash Course.Crash Course API Gateway.crashcourse-api-gateway-http-operations||target="blank"]]
69 -* [[HTTP Resources (Search Results)>>url:https://docs.emagiz.com/bin/view/Main/Search?sort=score&sortOrder=desc&highlight=true&facet=true&r=1&f_space_facet=0%2FMain.&l_space_facet=10&f_type=DOCUMENT&f_locale=en&f_locale=&f_locale=en&text=%22HTTP+Resources%22||target="blank"]]
70 -)))((({{toc/}}))){{/container}}{{/container}}
71 +* [[REST API naming concepts>>https://restfulapi.net/resource-naming/||target="blank"]]
72 +
73 +== 7. Silent demonstration video ==
74 +
75 +As this is a more theoretical microlearning no demonstration video is created. See you in the next microlearning.)))((({{toc/}}))){{/container}}{{/container}}