Getting your API keys
All calls to the Oracle Data Cloud web services must be authenticated using your API keys. Once your application receives a successful response to an authentication request, it can begin making API calls. See authenticating API calls for more information on authentication and authorization.
To get your API keys:
- Log in to partner.bluekai.com, click Tools, and click the Web Service Key Tool link. The web service key tool displays your web service user key (
bkuid), which is your unique ID for accessing the Oracle Data Cloud web services. If the Web Service Key Tool link is not displayed, contact My Oracle Support (MOS) and request access to Oracle Data Cloud web services. - Click Show Private Key to display your web service authentication key (
bksecretkey). The web services use this key and a HmacSHA256 encryption algorithm to generate your message signature.Important: Secure your authentication key to prevent unauthorized access to your data. Oracle may invalidate your authentication key if a malicious attack using your key is detected.
- Pass your user key and the request signature as arguments when you make calls to Oracle Data Cloud APIs. These keys are unique to each user account. If you need to reset them for any reason, contact MOS.
- Use the ping API to validate that you can use your API keys to send authenticated message requests to the web services.
Tip: If specified, the pid property sets the partner seat for the current authentication context for all Oracle Data Cloud platform APIs. This can be useful if the user account associated with your API keys has multiple partner seats. For details, see partner ID property.