Skip to Content
Last modified by Erik Bakker on 2024/08/23 11:32
From version 26.1
edited by Eva Torken
on 2023/04/20 11:16
Change comment: There is no comment for this version
To version 27.1
edited by Eva Torken
on 2023/04/20 11:27
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -11,17 +11,17 @@
11 11  == 2. Key concepts ==
12 12  
13 13  This microlearning centers around configuring a backend operation with the API Gateway solution of eMagiz.
14 -With backend operation we mean: Any action that is available to be executed on an internal system that you want to make publicly available via the API Gateway
15 -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
14 +With backend operation we mean: Any action that is available to be executed on an internal system that you want to make publicly available via the API Gateway.
15 +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.
16 16  
17 17  When setting up your API Gateway integration the process of doing things is to start at the backend operation and based on that expose an operation in the API Gateway.
18 18  
19 19  == 3. Configure a backend operation ==
20 20  
21 -When you look at the conceptual idea of the API Gateway, exposing backend operations via a centralized location to the outside world
22 -it stands to reason that when you set up your API Gateway (i.e. the front-end facing part) you start with the backend operation you want to expose.
21 +When you look at the conceptual idea of the API Gateway, exposing backend operations via a centralized location to the outside world.
22 +It stands to reason that when you set up your API Gateway (i.e. the front-end facing part) you start with the backend operation you want to expose.
23 23  
24 -Configuring backend operations is done in the Design phase of eMagiz. When you are in the Design overview you can double click on the backend system that holds the operation(s). This action will show you the following pop-up
24 +Configuring backend operations is done in the Design phase of eMagiz. When you are in the Design overview you can double click on the backend system that holds the operation(s). This action will show you the following pop-up:
25 25  
26 26  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend-operations--system-edit.png]]
27 27  
... ... @@ -33,7 +33,7 @@
33 33  If the answer to the above decisions is JSON and yes the default settings are correct you should continue to either import the OpenAPI 3.0 spec or manually configure at least one backend operation.
34 34  More on that later in this microlearning.
35 35  
36 -In case the answer to the first decision is XML you should switch the default format to XML and unselect the OpenAPI 3.0 spec. The result should be something like this.
36 +In case the answer to the first decision is XML you should switch the default format to XML and unselect the OpenAPI 3.0 spec. The result should be something like this:
37 37  
38 38  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend-operations--system-edit-xml-result.png]]
39 39  
... ... @@ -40,7 +40,7 @@
40 40  === 3.1 Importing a specification ===
41 41  
42 42  If the external party can provide you with an OpenAPI 3.0 specification you can manage your backend system by pressing the Import button
43 -when you are editing the system (double click on the system in question)
43 +when you are editing the system (double click on the system in question).
44 44  
45 45  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend-operations--system-edit-manage.png]]
46 46  
... ... @@ -49,7 +49,7 @@
49 49  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend-operations--import-open-api-pop-up.png]]
50 50  
51 51  Press Import and let eMagiz do the heavy lifting for you. eMagiz will now import all backend operations that are specified in the OpenAPI 3.0 JSON file you have selected.
52 -A result of such an import could be as follows.
52 +A result of such an import could be as follows:
53 53  
54 54  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend-operations--import-open-api-result.png]]
55 55  
... ... @@ -57,10 +57,10 @@
57 57  
58 58  === 3.2 Creating a specification ===
59 59  
60 -It can very well be that the external party has a swagger definition but not an OpenAPI 3.0 standard.
60 +It can very well be that the external party has a swagger definition, but not an OpenAPI 3.0 standard.
61 61  Or maybe they have other documentation that tells you the resource paths, parameters, and HTTP operations that you need.
62 62  
63 -In all these cases you can manage your backend system by pressing the Manage button when you are editing the system (double click on the system in question)
63 +In all these cases you can manage your backend system by pressing the Manage button when you are editing the system (double click on the system in question).
64 64  
65 65  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend-operations--system-edit-manage.png]]
66 66  
... ... @@ -68,16 +68,16 @@
68 68  
69 69  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend--manage-pop-up.png]]
70 70  
71 -Let us manually fill a simple GET call to retrieve all HTTP methods. So we start at the top left of the screen in the resource section and press New.
72 -In the pop-up that follows we enter the resource path that is defined in the specification and press Save. The result will be as follows.
71 +Let us manually fill a simple GET call to retrieve all HTTP methods. So, we start at the top left of the screen in the resource section and press New.
72 +In the pop-up that follows, we enter the resource path that is defined in the specification and press Save. The result will be as follows:
73 73  
74 74  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend--manage-pop-up-resource-filled-in.png]]
75 75  
76 -The next step will be to add an operation via the option New under Operations in the middle of your screen. The result of that action will be something as follows.
76 +The next step will be to add an operation via the option New under Operations in the middle of your screen. The result of that action will be something as follows:
77 77  
78 78  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend--manage-pop-up-operation-filled-in.png]]
79 79  
80 -As there are no parameters in this case you have now successfully configured your first backend operation. When you close this screen you will see the results on system level
80 +As there are no parameters in this case you have now successfully configured your first backend operation. When you close this screen you will see the results on system level.
81 81  
82 82  [[image:Main.Images.Microlearning.WebHome@crashcourse-api-gateway-configure-backend--pop-up-result.png]]
83 83