Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Follow these few simple steps to create your first emite IPaaS Integration and retrieve data from a Wikipedia API:

67911

#

Step

Example Screenshot

Instructions

1

Login:

image-20250211-113949.png

Login into your emite IPaaS Tenant using the username and password provided.

If you do not have a username or password, please reach out to your emite account team to enable IPaaS for your organization.

2

Select your Tenant:

image-20250211-114526.png

Select your Tenant using the drop down selector and click ‘Next’.

3

Create an Integration:

image-20250211-115215.png

Click on ‘Create Integration’ to create a new Integration.

4

Name your Integration:

image-20250211-114929.png

5

Create an Action:

image-20250211-115330.pngImage Removed

Enter ‘Wikipedia Integration’ into the ‘Integration Name’ field and click ‘Create’.

5

Create a new empty Empty Action:

image-20250211-120822.png

Click on ‘Create Action’ and select ‘Empty Action’.

6

Name the Action:

image-20250211-121703.png

8

Input a URL and request parameter, and click create:

image-20250211-122316.pngImage Removed

Enter ‘Search Wikipedia’ into the ‘Name’ field.

7

Configure your action:

image-20250211-122316.pngImage Added

Select Method ‘GET’.

Enter the following URL into the ‘URL’ field: https://en.wikipedia.org/w/rest.php/v1/search/page?q={{searchTerm}}&limit=10

Click on the ‘Add More Parameters’ button.

Add a parameter with a Key ‘searchTerm’ and Value ‘Earth’.

Click ‘Create’.

8

Receive success message:

image-20250211-122432.png

10

Select id, title, excerpt and description and click import:

image-20250211-123120.pngImage Removed

After receiving a success message, click ‘Update’.

If you receive an error, please double-check the previous steps.

9

Select your field mappings:

image-20250211-123120.pngImage Added

Click the drop down arrow next to ‘Retrieve all available fields from API response body.

Select the description, excerpt, id and title fields.

Click ‘Import’.

10

Success message:

image-20250211-123148.png

12

Click save and then test:

image-20250211-123344.pngImage Removed

After receiving a success message, click ‘OK’.

If you receive an error, please double-check the previous steps.

11

Save and test your action:

image-20250211-123344.pngImage Added

Click ‘Save’ and then click ‘Test’.

If you receive an error, please double-check the previous steps.

Panel
panelIconId1f973
panelIcon:partying_face:
panelIconText🥳
bgColor#DEEBFF

Congratulations on successfully creating your first emite IPaaS Integration! You have configured emite IPaaS to connect to Wikipedia’s API and retrieved information about the 10 top pages relating to your search term.

Panel
panelIconIdatlassian-yellow_star
panelIcon:yellow_star:
panelIconText:yellow_star:
bgColor#DEEBFF

What to do next?

  • You can adjust try adjusting your search term parameter, back in the Request Parameters section, then re-save and re-test your Action to see what other Wikipedia data you can ingest into IPaaS.

  • You can try building integrations to some other Wikipedia API’s: https://www.mediawiki.org/wiki/API:REST_API (Wikipedia API’s are easy to use because they are publicly accessible and require no authentication)

  • You can apply try applying various rules and transformations to the your ingested data. See xyzPlease refer to: emite IPaaS User Interface

  • You can save try saving the retrieved data in a connected data store (ElasticsearchElasticSearch, opensearchOpenSearch) for emite in order to then visualize within emite. If you do not have a connected data store, please reach out to your emite account team to enable emite IPaaS for your organization.

  • You can publish try publishing a schedule to always keep the data up-to-date and have your integration constantly retrieve new records. See xyzYou can save your data to your integration’s cache, to reduce the number of API calls required for subsequent action executions.and updated records: emite IPaaS User Interface