Getting started with Notify API
Notify API is a key component in how ADE manages file-based data ingestion from cloud storage into the target database. It allows external systems to notify ADE when new data files are ready to be processed. Each notification includes file format metadata and file paths, packaged into a structured message called a manifest, which informs ADE how to generate a file load command to the target database.
This guide introduces the core concepts of the notification process, provides links to related resources for deeper understanding, and includes examples that demonstrate how the file load process works in practice.
See also:
Notify API - Notify API reference documentation
API Access and Setup - Getting access to Notify API
Setting Up a File Notifier Application - How to set up an application for the notifying process
Loading Source Data - Guide to file loads
ADE File Notifier Reference (GitHub) - Notifier solution example
Terminology
Term | Description |
---|---|
Notify API | ADE API used to notify ADE about new files available for loading from cloud storage. |
Source entity | An entity created in ADE with the entity type set to |
Source system | A source system defined in the CONFIG_SYSTEMS configuration package. Used to group and manage related source entities. |
Manifest | A manifest is a notification message sent to the Notify API, containing metadata and file paths related to loadable source data files. It groups one or more files (entries) under a shared context (body) that defines how the files should be interpreted and processed by ADE. A single manifest can only contain entries for one source entity.
|
Notify | Closing a manifest, i.e. informing ADE that all file entries are complete and the manifest is ready to be processed and loaded. |
Notifier application | A set of services deployed in the customer's cloud environment that detects file events and posts them to the Notify API. |
How Notify API maps to SOURCE entities
In Notify API calls, the combination of source system name and source entity name in the request URL identify the SOURCE entity.
For example, the following Notify API URL:
{baseUrl}/notify-api/tenants/local/installations/local/environments/local/source-systems/source-systems/digitraffic/source-entities/metadata_vessels/manifests
Maps to an entity with:
Entity type =
SOURCE
Source system =
DIGITRAFFIC
Entity name =
METADATA_VESSELS

Note that the Notify API URLs are always in lower case, see more details in the Notify API reference.
Examples
Manifests and entries posted to Notify API will be used by ADE to generate load commands to the target database.
See examples: