Customer 360 Data Manager Data Jobs API Developer Guide

Quick Start
Prerequisites
Data Jobs API FAQ
Supported OAuth Flows
Call the Data Job API
Data Jobs API Implementation
Data Jobs API RAML Spec
Status Codes and Error Responses
Troubleshooting Error Codes
PDF

Call the Data Job API

Quick example of how to call the Data Job API.

To call the API, you must have already completed the other tasks in the Quick Start.


User Permissions Needed
To use the Developer Console: API Enabled AND View All Data
To view, retain, and delete debug logs: View All Data
To execute anonymous Apex: Author Apex
To use code search and run SOQL or SOSL on the query tab: API Enabled
To save changes to Apex classes and triggers: Author Apex
To save changes to Visualforce pages and components: Customize Application
To save changes to Lightning resources: Customize Application
To access the Customer 360 Data Manager org System Administrator

You can use any tool of your choice to call the API. The code examples in this guide use a command-line tool called cURL to simplify sending and receiving HTTP requests and responses.

cURL is pre-installed on many Linux and Mac systems. Windows users can download a version at curl.haxx.se/. When using HTTPS on Windows, ensure that your system meets the cURL requirements for SSL.

The Base URI includes the API Gateway FQDN and the product domain. The API Gateway FQDN depends on the region of the Customer 360 Data Manager org.
Table 1. Regional FQDN
Region Base URI
North America na.api-salesforce.com
Europe eu.api-salesforce.com
Asia/Pacific ap.api-salesforce.com

The required domain for the Data Jobs API is datamanager.

Example: URL for the Jobs resource
  1. Open your command line.
  2. To retrieve an access token, make an authentication call. Use the Customer 360 Data Manager org name as the instance_url. If you’re developing an app, the connected app provides this access token, this call is only necessary for the examples that use cURL.
    • login_url: use the URL you use to log in to Salesforce.
    • client_id: use the connected app consumer key.
    • client_secret: use the connected app consumer secret.
    • username: use the username you use to log in to Salesforce.
    • password: use the password you use to log in to Salesforce.
    This result is an example:

    The information in the token is required for calls to the DJ API.

    Note

  3. Use one of the resources of the API. You need information for the headers, URI parameters, and authentication token. The x-sfdc-domain header value is derived from the instance_url returned in the authentication token.
    This result is an example: