Self-Serve Sources (Batch SDK) allows you to integrate your own REST-based source to bring batch data to Adobe Experience Platform. This document provides an introduction to the core concepts you need to know before attempting to make calls to the Flow Service API.
To use Self-Serve Sources (Batch SDK), you must ensure that you have access to an organization Sandbox provisioned with Adobe Experience Platform Sources.
This guide also requires a working understanding of the following components of Adobe Experience Platform:
The Self-Serve Sources (Batch SDK) and Flow Service API documentation provides example API calls to demonstrate how to format your requests. These include paths, required headers, and properly formatted request payloads. Sample JSON returned in API responses is also provided. For information on the conventions used in documentation for sample API calls, see the section on how to read example API calls in the Experience Platform troubleshooting guide.
In order to make calls to Platform APIs, you must first complete the authentication tutorial. Completing the authentication tutorial provides the values for each of the required headers in all Experience Platform API calls, as shown below:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
All resources in Platform, including those belonging to Flow Service, are isolated to specific virtual sandboxes. All requests to Platform APIs require a header that specifies the name of the sandbox the operation will take place in:
x-sandbox-name: {SANDBOX_NAME}
For more information on sandboxes in Platform, see the sandbox documentation.
All requests that contain a payload (POST, PUT, PATCH) require an additional header:
Content-Type: application/json
To begin creating a new source with Self-Serve Sources (Batch SDK), see the tutorial on creating a new source.