REST API Reference

Back Next

Login

Use the login resource to log in to

Informatica Intelligent Cloud Services

to use version 3 REST API resources.

The login response includes the session ID and base URL that you need to include in the REST API calls that you make during the session.

Use values from the following fields:

sessionId. A REST API session ID that you include in the header for REST API calls. The session ID expires after 30 minutes of inactivity. After the session ID expires, log in again to continue working with the REST API.

For information on retrieving session status details, see Session IDs.

baseApiUrl. The base URL that you use in all version 3 resource URIs except for login, for example:

<baseApiUrl>/public/core/v3/lookup

Your team might use multiple organizations such as an organization for development and an organization for testing. The user credentials that you use to log in determine the organization that you access.

POST request

To log in, use the following URL:

https://<cloud provider>-<region>.informaticacloud.com/saas/public/core/v3/login

The values for cloud provider and region correspond to the name of the POD (Point of Deployment) that your organization uses. The following table lists the POD names and the corresponding cloud provider and region to use in the login URL

POD name	Cloud provider-region
USW1	dm-us
USE2	dm-us
USW3	dm-us
USE4	dm-us
USW5	dm-us
USE6	dm-us
USW1-1	dm1-us
USW3-1	dm1-us
USW1-2	dm2-us
CAC1	dm-na
APSE1	dm-ap
APSE2	dm1-apse
APNE1	dm1-ap
APNE2	dm-apne
APAUC1	dm1-apau
EMW1	dm-em
EMC1	dm1-em
UK1	dm-uk

For example, if your organization uses the APNE1 POD, use the following URL:

https://dm1-ap.informaticacloud.com/saas/public/core/v3/login

If you don't know the name of the POD that your organization uses, contact your organization administrator or Informatica Global Customer Support.

For more information about the POD names and corresponding cloud providers and regions, see the Product Availability Matrix (PAM) for Informatica Intelligent Cloud Services on the Knowledge Base.

Use the following fields in a login object:

Field	Type	Required	Description
username	String	Yes	Informatica Intelligent Cloud Services user name for the organization that you want to log in to. Maximum length is 255 characters.
password	String	Yes	Informatica Intelligent Cloud Services password. Maximum length is 255 characters.

POST response

Returns user information if the request is successful. Returns the error object if errors occur.

Use the base URL and session ID returned in the response for subsequent requests during this session.

A successful request returns the following objects:

Field	Type	Description
products	Collection	Subscribed Informatica products.
name	String	Product name.
baseApiUrl	String	Returned in the product object. Base API URL for the product. Use in REST API requests.
userInfo	Collection	User information.
sessionId	String	Returned in the userInfo object. REST API session ID for the current session. Use in most REST API request headers.
id	String	Returned in the userInfo object. User ID.
name	String	User name.
parentOrgId	String	Organization ID for the parent organization.
orgId	String	Returned in the userInfo object. ID of the organization the user belongs to. 22 characters.
orgName	String	Returned in the userInfo object. Organization name.
groups	Collection	User group information for the user.
status	String	Status of the user. Returns one of the following values: Active Inactive

POST example

To log in to your

Informatica Intelligent Cloud Services

organization, you might use the following request:

POST https://dm-us.informaticacloud.com/saas/public/core/v3/login 
Content-Type: application/json
Accept: application/json

{
    "username": "user@informatica.com",
    "password": "mypassword"
}

If successful, the response includes the products and userInfo objects which contain the baseApiUrl and sessionId values to use in subsequent calls, as shown in the following example:

{
 	"products": [
 		{
 			"name": "Integration Cloud",
 			"baseApiUrl": "https://usw3.dm-us.informaticacloud.com/saas"
 		}
 	],
 	"userInfo": {
 		"sessionId": "9KA11tLGqxVcGeul8SQBK3",
 		"id": "9L1GFroXSDHe2IIg7QhBaT",
 		"name": "user",
 		"parentOrgId": "52ZSTB0IDK6dXxaEQLUaQu",
 		"orgId": "0cuQSDTq5sikvN7x8r1xm1",
 		"orgName": "MyOrg_INFA",
 		"groups": {},
 		"status": "Active"
 	}
}

Using the session ID and base URL values in the above response as an example, to send a GET request to obtain license information, you might use the following request:

GET https://usw3.dm-us.informaticacloud.com/saas/public/core/v3/license/org/0cuQSDTq5sikvN7x8r1xm1
Content-Type: application/json
Accept: application/json
INFA-SESSION-ID: 9KA11tLGqxVcGeul8SQBK3

Platform REST API version 3 resources

Download Guide

Watch

Comments

Cloud B2B Gateway Homepage