Oracle CRM On Demand REST API Developer's Guide > Getting Started with the Oracle CRM On Demand REST API > About Oracle CRM On Demand REST API Authentication >

Login with Oracle CRM On Demand REST API

You can use the Oracle CRM On Demand REST API connection request to initiate an Oracle CRM On Demand server session.

You can request an Oracle CRM On Demand server session and obtain a valid session ID by sending an HTTP GET request to the following URL:

/OnDemand/user/Rest/Connection

Request Header:

Authorization: Basic cmVzdC91c2VyMTpVc2VyMTI4NQ==

In the example above, the authorization was added as a request header that has the value of the username followed by a colon and then the password encoded in Base 64. A basic string was added to indicate basic authentication.

A successful logon request returns an HTTP status code of 200 and the JSESSIONID is returned in the JSESSION response header. For more information about HTTP status codes, see Standard HTTP Status Codes.

If the Oracle CRM On Demand server session times out for any reason, the error returned reports that the session is not valid and you must then request a new Oracle CRM On Demand session.

After local authentication, Oracle CRM On Demand authenticates you against the login server when an application makes a REST API request. After credentials are authenticated, Oracle CRM On Demand executes the REST API request, allowing you to interact with the Oracle CRM On Demand server to perform data retrieval, modification, creation, and deletion operations. The REST API response returns a valid JSESSIONID value, which is used for authenticating subsequent requests. The response also includes metadata about the connection session. For more information about connection attributes, see REST API Connection Attributes.