Making a POST Request Using Informatica Cloud REST API Connector

Transcription

1 Making a POST Request Using Informatica Cloud REST API Connector Copyright Informatica LLC 2016, Informatica, the Informatica logo, and Informatica Cloud are trademarks or registered trademarks of Informatica LLC in the United States and many jurisdictions throughout the world. A current list of Informatica trademarks is available on the web at

2 Abstract REST API Connector connects to REST-based web service applications that are either internal to an organization or external applications. You can use REST API Connector to make GET, POST, PUT, and DELETE requests to the REST-based web service applications. You make a POST request to create a resource when the resource identifier is not known. The server creates the resource and returns the resource identifier for the created resource in the API response. This article describes how you can configure REST API Connector to make POST request to a Twitter REST API. Supported Versions Informatica Cloud Fall 2016 Table of Contents Overview Create a REST API Connection Create a Data Synchronization Task Overview You are an operation manager in a marketing services organization. At regular intervals, you need to tweet the marketing content for your multiple clients. Instead of accessing Twitter account for each client every time, you can use Informatica Cloud REST API Connector to call the Twitter Update API. To make a POST request to a REST API, you configure the payload required by the API when you create a task. The Twitter Update API does not require a payload. Therefore, in this example, you configure the text to be tweeted in Field Mapping without configuring a payload. This example does not parse the response of the POST request. Perform the following steps: 1. Create a REST API Connection. 2. Create and run a Data Synchronization task. Create a REST API Connection 1. Click Configure > Connections. 2. Click New to create a connection. The New Connection page appears. 3. Specify the following details: Connection Property Connection Name Type Enter a unique name for the connection. Provide a relevant description for the connection. Select ReST (Informatica Cloud Labs) from the list. 2

3 Connection Property Runtime Environment Base URL Url Request Parameters Media Type Request Type Authentication Type OAuth Consumer Key OAuth Consumer Secret OAuth Token OAuth Token Secret Response Folder Path Create the config csv file Select the appropriate runtime environment from the list. Enter the Twitter Update API URL, update.json. Enter the status. For example:status=testtweet Select application/json. Select POST. Select OAUTH. Provide Oauth consumer key for your Twitter account. Provide Oauth consumer secret key for your Twitter account. Provide Oauth token for your Twitter account. Provide OAuth token secret for your Twitter account. Provide the path on Secure Agent machine where you want to generate the response file. Select No. 3

4 The following image shows the sample values: 4. Click Ok to save the connection. 4

5 Create a Data Synchronization Task To make a POST request, configure the REST API endpoint as a target. Before you create a Data Synchronization task, create a flat file and save the text that you want to tweet. For example, TwitterStatus.txt. Create a flat file connection to access TwitterStatus.txt file in the Data Synchronization task. 1. To create a Data Synchronization task, click Task Wizards > Data Synchronization, and then click New. 2. In the Data Synchronization Task Details area, configure the following fields: Field Task Name Task Operation Name of the Data Synchronization task. For example: REST_TwitterUpdate of the Data Synchronization task. Maximum length is 255 characters. Select Insert. 3. Click Next. 4. On the Source page, configure the following fields: Field Connection Source Type Source Object Select the flat file connection. Select Single. Select TwitterStatus.txt. 5. Click Next. 6. On the Target page, configure the following fields: Field Connection Target Object Select the connection you created. For example: TwitterUpdate_REST Select update_json 7. Click Next. 8. Click Next. 9. On the Field Mapping page, map the TwitterStatus.txt source file to the URLPARAM_status field of the target object. If your POST call has a payload, define the payload in a flat file, and map the absolute path of the file to PAYLOAD_FileName in Field Mapping. The following image shows the field mapping for 5

6 URLPARAM_status field: 10. Click Validate Mapping. 11. Save and run the Data Synchronization task. After the task is completed successfully, the text sent to the Twitter API is tweeted. You can check the response in the update_json.json file generated by the Twitter Update API in the response folder path you specified in the REST API connection properties. Author Chanchal Das Lead Technical Writer Acknowledgements Thanks to Gomaram, Shashidhar Reddy for his help in completing this article. 6