Data Hub REST API Documentation 6.5
Data Feeds
Returns all data feeds that have been created in the Data Hub
Creates a new data feed in the Data Hub
get /data-feeds
Returns all data feeds that have been created in the Data Hub
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-feeds#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "data-feeds",
"description": "A collection of data feeds",
"type": "array",
"items": "#/data-feed"
}
Secured by Basic_Authentication
post /data-feeds
Creates a new data feed in the Data Hub
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-feed#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single data feed",
"properties": {
"name": {
"type": "string",
"description": "Name of the data feed"
},
"description": {
"type": "string",
"description": "A comment describing the data feed"
},
"feedId": {
"type": "integer",
"description": "ID of the data feed"
},
"poolingStrategy" : {
"description": "Strategy to determine the id of the correct pool for this feed to use for its next inputs",
"enum" : ["NAMED_POOL", "GLOBAL_POOL", "NEW_POOL_FOR_INPUT"]
} ,
"poolingCondition" : {
"description": "Name of the pool used",
"type" : "string"
} ,
"defaultCompositionStrategy" : {
"description": "The default composition strategy to be used by all pools under this data feed",
"type" : "string"
} ,
"defaultPublicationStrategy" : {
"description": "The default publication strategy to be used by all pools under this data feed",
"type" : "string"
}
},
"required": ["name"]
}
HTTP status code 201
Headers
- Location: (string)
A URL of the created data-feed
Example:
Location: https://somewhere.net/resources/123
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-feed#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single data feed",
"properties": {
"name": {
"type": "string",
"description": "Name of the data feed"
},
"description": {
"type": "string",
"description": "A comment describing the data feed"
},
"feedId": {
"type": "integer",
"description": "ID of the data feed"
},
"poolingStrategy" : {
"description": "Strategy to determine the id of the correct pool for this feed to use for its next inputs",
"enum" : ["NAMED_POOL", "GLOBAL_POOL", "NEW_POOL_FOR_INPUT"]
} ,
"poolingCondition" : {
"description": "Name of the pool used",
"type" : "string"
} ,
"defaultCompositionStrategy" : {
"description": "The default composition strategy to be used by all pools under this data feed",
"type" : "string"
} ,
"defaultPublicationStrategy" : {
"description": "The default publication strategy to be used by all pools under this data feed",
"type" : "string"
}
},
"required": ["name"]
}
Secured by Basic_Authentication
Returns all data loading actions for a data feed
get /data-feeds/data-loads
Returns all data loading actions for a data feed
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned data-loads.
- pageSize: (integer - default: 50)
The size of a returned page of data-loads.
- q: (string)
Query string in lucene syntax. Supported term is 'status' (0-many)
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-loading-actions#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "data-loading-actions",
"description": "A page containing a collection of data loading actions",
"type": "array",
"items": "#/data-loading-action"
}
Secured by Basic_Authentication
Returns data feed information
get /data-feeds/{feedName}
Returns data feed information
URI Parameters
- feedName: required (string)
Name of the data feed
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-feed#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single data feed",
"properties": {
"name": {
"type": "string",
"description": "Name of the data feed"
},
"description": {
"type": "string",
"description": "A comment describing the data feed"
},
"feedId": {
"type": "integer",
"description": "ID of the data feed"
},
"poolingStrategy" : {
"description": "Strategy to determine the id of the correct pool for this feed to use for its next inputs",
"enum" : ["NAMED_POOL", "GLOBAL_POOL", "NEW_POOL_FOR_INPUT"]
} ,
"poolingCondition" : {
"description": "Name of the pool used",
"type" : "string"
} ,
"defaultCompositionStrategy" : {
"description": "The default composition strategy to be used by all pools under this data feed",
"type" : "string"
} ,
"defaultPublicationStrategy" : {
"description": "The default publication strategy to be used by all pools under this data feed",
"type" : "string"
}
},
"required": ["name"]
}
Secured by Basic_Authentication
Deletes canonical items by type
delete /data-feeds/{feedName}/types/{itemType}
Deletes canonical items by type
URI Parameters
- feedName: required (string)
Name of the data feed
- itemType: required (string)
The type of raw items created through the data feed that will be operated on
Query Parameters
- rawFields: (string)
JSON formatted object of the names and values used to identify the raw item. This raw item is the source that the deleted items originated from.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/result#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "Result of deleting items",
"properties": {
"numberProcessed": {
"description": "Number of items that were deleted",
"type": "integer"
}
}
}
Secured by Basic_Authentication
Returns all pools in a particular data feed
Creates a new pool
get /data-feeds/{feedName}/pools
Returns all pools in a particular data feed
URI Parameters
- feedName: required (string)
Name of the data feed
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned pools.
- pageSize: (integer - default: 50)
The size of a returned page of pools.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/pools#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "pools",
"description": "A collection of data pools",
"type": "array",
"items": "#/pool"
}
Secured by Basic_Authentication
post /data-feeds/{feedName}/pools
Creates a new pool
URI Parameters
- feedName: required (string)
Name of the data feed
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/pool#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single data pool",
"properties": {
"poolId": {
"description": "ID of the data pool",
"type": "integer"
},
"poolName": {
"description": "Name of the data pool",
"type": "string"
},
"compositionStrategy": {
"description": "Name of the composition strategy for the data pool",
"type": "string"
},
"publicationStrategy": {
"description": "Name of the publication strategy for the data pool",
"type": "string"
}
},
"required": ["poolName"]
}
HTTP status code 201
Headers
- Location: (string)
A URL of the created pool
Example:
Location: https://somewhere.net/resources/123
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/pool#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single data pool",
"properties": {
"poolId": {
"description": "ID of the data pool",
"type": "integer"
},
"poolName": {
"description": "Name of the data pool",
"type": "string"
},
"compositionStrategy": {
"description": "Name of the composition strategy for the data pool",
"type": "string"
},
"publicationStrategy": {
"description": "Name of the publication strategy for the data pool",
"type": "string"
}
},
"required": ["poolName"]
}
Secured by Basic_Authentication
Pools
Returns a page of pools
Creates a new pool
get /pools
Returns a page of pools
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned pools.
- pageSize: (integer - default: 50)
The size of a returned page of pools.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/pools#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "pools",
"description": "A collection of data pools",
"type": "array",
"items": "#/pool"
}
Secured by Basic_Authentication
post /pools
Creates a new pool
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/pool#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single data pool",
"properties": {
"poolId": {
"description": "ID of the data pool",
"type": "integer"
},
"poolName": {
"description": "Name of the data pool",
"type": "string"
},
"compositionStrategy": {
"description": "Name of the composition strategy for the data pool",
"type": "string"
},
"publicationStrategy": {
"description": "Name of the publication strategy for the data pool",
"type": "string"
}
},
"required": ["poolName"]
}
HTTP status code 201
Headers
- Location: (string)
A URL of the created pool
Example:
Location: https://somewhere.net/resources/123
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/pool#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single data pool",
"properties": {
"poolId": {
"description": "ID of the data pool",
"type": "integer"
},
"poolName": {
"description": "Name of the data pool",
"type": "string"
},
"compositionStrategy": {
"description": "Name of the composition strategy for the data pool",
"type": "string"
},
"publicationStrategy": {
"description": "Name of the publication strategy for the data pool",
"type": "string"
}
},
"required": ["poolName"]
}
Secured by Basic_Authentication
Returns pool information by pool name
get /pools/{poolName}
Returns pool information by pool name
URI Parameters
- poolName: required (string)
Name of the pool
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/pool#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single data pool",
"properties": {
"poolId": {
"description": "ID of the data pool",
"type": "integer"
},
"poolName": {
"description": "Name of the data pool",
"type": "string"
},
"compositionStrategy": {
"description": "Name of the composition strategy for the data pool",
"type": "string"
},
"publicationStrategy": {
"description": "Name of the publication strategy for the data pool",
"type": "string"
}
},
"required": ["poolName"]
}
Secured by Basic_Authentication
Returns all compositions by pool name
Initiates composition by pool name
get /pools/{poolName}/compositions
Returns all compositions by pool name
URI Parameters
- poolName: required (string)
Name of the pool
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/composition-actions#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "composition-actions",
"description": "A collection of data pool composition actions",
"type": "array",
"items": "#/composition"
}
Secured by Basic_Authentication
post /pools/{poolName}/compositions
Initiates composition by pool name
URI Parameters
- poolName: required (string)
Name of the pool
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/composition#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single composition action",
"type": "object",
"properties": {
"actionId": {
"description": "ID of the composition action",
"type": "integer"
},
"poolName": {
"description": "Name of the pool",
"type": "string"
},
"startTime": {
"description": "The timestamp for when the Composition action started",
"type": "datetime"
},
"endTime": {
"description": "The timestamp for when the Composition action ended",
"type": "datetime"
},
"type": {
"description": "Type of the pool action. Namly COMPOSITION",
"enum": ["COMPOSITION"]
},
"status": {
"description": "Composition status",
"enum": ["SUCCESS", "IN_PROGRESS", "FAILURE", "PENDING", "COMPLETE_W_ERRORS"]
},
"actionId": {
"description": "Count of canonical items created during the composition action",
"type": "integer"
}
},
"required": ["started"]
}
HTTP status code 201
Headers
- Location: (string)
A URL of the created composition
Example:
Location: https://somewhere.net/resources/123
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/composition#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single composition action",
"type": "object",
"properties": {
"actionId": {
"description": "ID of the composition action",
"type": "integer"
},
"poolName": {
"description": "Name of the pool",
"type": "string"
},
"startTime": {
"description": "The timestamp for when the Composition action started",
"type": "datetime"
},
"endTime": {
"description": "The timestamp for when the Composition action ended",
"type": "datetime"
},
"type": {
"description": "Type of the pool action. Namly COMPOSITION",
"enum": ["COMPOSITION"]
},
"status": {
"description": "Composition status",
"enum": ["SUCCESS", "IN_PROGRESS", "FAILURE", "PENDING", "COMPLETE_W_ERRORS"]
},
"actionId": {
"description": "Count of canonical items created during the composition action",
"type": "integer"
}
},
"required": ["started"]
}
Secured by Basic_Authentication
Returns the composition action by ID
get /pools/{poolName}/compositions/{actionId}
Returns the composition action by ID
URI Parameters
- poolName: required (string)
Name of the pool
- actionId: required (integer)
The action ID of the composition
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/composition#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single composition action",
"type": "object",
"properties": {
"actionId": {
"description": "ID of the composition action",
"type": "integer"
},
"poolName": {
"description": "Name of the pool",
"type": "string"
},
"startTime": {
"description": "The timestamp for when the Composition action started",
"type": "datetime"
},
"endTime": {
"description": "The timestamp for when the Composition action ended",
"type": "datetime"
},
"type": {
"description": "Type of the pool action. Namly COMPOSITION",
"enum": ["COMPOSITION"]
},
"status": {
"description": "Composition status",
"enum": ["SUCCESS", "IN_PROGRESS", "FAILURE", "PENDING", "COMPLETE_W_ERRORS"]
},
"actionId": {
"description": "Count of canonical items created during the composition action",
"type": "integer"
}
},
"required": ["started"]
}
Secured by Basic_Authentication
Returns a page of publications by pool name. The default page size is 50.
Initiates publication by pool name
get /pools/{poolName}/publications
Returns a page of publications by pool name. The default page size is 50.
URI Parameters
- poolName: required (string)
Name of the pool
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned publications.
- pageSize: (integer - default: 50)
The size of a returned page of publications.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/publications#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "composition-actions",
"description": "A collection of publication actions",
"type": "array",
"items": "#/publication"
}
Secured by Basic_Authentication
post /pools/{poolName}/publications
Initiates publication by pool name
URI Parameters
- poolName: required (string)
Name of the pool
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/publication#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single publication action",
"type": "object",
"properties": {
"actionId": {
"description": "ID of the publication action",
"type": "integer"
},
"type":{
"description": "Name of the pool",
"enum": ["PUBLICATION", "RETRY_ITEMS_PUBLICATION"]
},
"poolName": {
"description": "Name of the pool",
"type": "string"
},
"startTime": {
"description": "The timestamp for when the Publication started",
"type": "datetime"
},
"endTime": {
"description": "The timestamp for when the Publication ended",
"type": "datetime"
},
"status": {
"description": "Publication status",
"enum": ["SUCCESS", "IN_PROGRESS", "COMPLETE_W_ERRORS", "FAILURE", "PENDING"]
},
"targetSystemPublications": {
"description": "A collection of target system publications",
"type": "array",
"items": "#/target-system-publication"
}
},
"required":["targetSystemPublications"]
}
HTTP status code 201
Headers
- Location: (string)
A URL of the created publication
Example:
Location: https://somewhere.net/resources/123
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/publication#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single publication action",
"type": "object",
"properties": {
"actionId": {
"description": "ID of the publication action",
"type": "integer"
},
"type":{
"description": "Name of the pool",
"enum": ["PUBLICATION", "RETRY_ITEMS_PUBLICATION"]
},
"poolName": {
"description": "Name of the pool",
"type": "string"
},
"startTime": {
"description": "The timestamp for when the Publication started",
"type": "datetime"
},
"endTime": {
"description": "The timestamp for when the Publication ended",
"type": "datetime"
},
"status": {
"description": "Publication status",
"enum": ["SUCCESS", "IN_PROGRESS", "COMPLETE_W_ERRORS", "FAILURE", "PENDING"]
},
"targetSystemPublications": {
"description": "A collection of target system publications",
"type": "array",
"items": "#/target-system-publication"
}
},
"required":["targetSystemPublications"]
}
Secured by Basic_Authentication
Returns the publication action by ID
get /pools/{poolName}/publications/{actionId}
Returns the publication action by ID
URI Parameters
- poolName: required (string)
Name of the pool
- actionId: required (integer)
The action ID of the publication
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/publication#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single publication action",
"type": "object",
"properties": {
"actionId": {
"description": "ID of the publication action",
"type": "integer"
},
"type":{
"description": "Name of the pool",
"enum": ["PUBLICATION", "RETRY_ITEMS_PUBLICATION"]
},
"poolName": {
"description": "Name of the pool",
"type": "string"
},
"startTime": {
"description": "The timestamp for when the Publication started",
"type": "datetime"
},
"endTime": {
"description": "The timestamp for when the Publication ended",
"type": "datetime"
},
"status": {
"description": "Publication status",
"enum": ["SUCCESS", "IN_PROGRESS", "COMPLETE_W_ERRORS", "FAILURE", "PENDING"]
},
"targetSystemPublications": {
"description": "A collection of target system publications",
"type": "array",
"items": "#/target-system-publication"
}
},
"required":["targetSystemPublications"]
}
Secured by Basic_Authentication
Returns a list of target system publications by action ID
get /pools/{poolName}/publications/{actionId}/target-system-publications
Returns a list of target system publications by action ID
URI Parameters
- poolName: required (string)
Name of the pool
- actionId: required (integer)
The action ID of the publication
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/target-system-publications#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "publication-actions",
"description": "A collection of target system publications",
"type": "array",
"items": "#/target-system-publication"
}
Secured by Basic_Authentication
Returns all actions by pool name
get /pools/{poolName}/pool-history
Returns all actions by pool name
URI Parameters
- poolName: required (string)
Name of the pool
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/pool-actions#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "composition-actions",
"description": "A collection of data pool actions",
"type": "array",
"items": "#/pool-action"
}
Secured by Basic_Authentication
Returns a page of items by type and pool name
Deletes canonical items by type
get /pools/{poolName}/items/{itemType}
Returns a page of items by type and pool name
URI Parameters
- poolName: required (string)
Name of the pool
- itemType: required (string)
The type of item to be returned
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned items.
- pageSize: (integer - default: 50)
The size of a returned page of items.
- q: (string)
Query string in lucene syntax. Supported terms are 'status' (0-many) or any fields that form the primary key fields and values of a canonical item.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-items#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "item-type-definitions",
"description": "A collection of data items",
"type": "array",
"items": "#/item-type-definition"
}
Secured by Basic_Authentication
delete /pools/{poolName}/items/{itemType}
Deletes canonical items by type
URI Parameters
- poolName: required (string)
Name of the pool
- itemType: required (string)
The type of item to be returned
Query Parameters
- keyFields: (string)
JSON formatted object of the names and values that identify the key fields of the specified canonical item
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/result#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "Result of deleting items",
"properties": {
"numberProcessed": {
"description": "Number of items that were deleted",
"type": "integer"
}
}
}
Secured by Basic_Authentication
Returns the addition for all pools of all status counts for all item types.
get /pools/{poolName}/status-counts
Returns the addition for all pools of all status counts for all item types.
URI Parameters
- poolName: required (string)
Name of the pool
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/item-status-counts#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "The status counts of all data types per pool",
"properties": {
"rawItemStatusCount": {
"description": "Status counts for all raw items grouped by pool if the request had a pool specified or the addition of all pools if no pool was specified",
"type": "raw-item-status-counts"
},
"canonicalItemStatusCount": {
"description": "Status counts for all canonical items grouped by pool if the request had a pool specified or the addition of all pools if no pool was specified",
"type": "canonical-item-status-counts"
},
"canonicalPublicationItemStatusCount": {
"description": "Status counts for all canonical item publications grouped by pool if the request had a pool specified or the addition of all pools if no pool was specified",
"type": "canonical-publication-item-status-counts"
}
}
}
Secured by Basic_Authentication
Returns the addition for all pools of all status counts for raw items.
get /pools/{poolName}/status-counts/raw
Returns the addition for all pools of all status counts for raw items.
URI Parameters
- poolName: required (string)
Name of the pool
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/raw-item-status-counts#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "The status counts of all raw items per pool",
"properties": {
"poolName": {
"description": "The name of the pool for the counts, or null if the pool is not specified in the request path",
"type": "string"
},
"ignoredCount": {
"description": "The number of raw items in IGNORED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"pendingCount": {
"description": "The number of raw items in PENDING state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"processedCount": {
"description": "The number of raw items in PROCESSED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
}
}
}
Secured by Basic_Authentication
Returns the addition for all pools of all status counts for canonical items.
get /pools/{poolName}/status-counts/canonical
Returns the addition for all pools of all status counts for canonical items.
URI Parameters
- poolName: required (string)
Name of the pool
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/canonical-item-status-counts#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "The status counts of all canonical items per pool",
"properties": {
"poolName": {
"description": "The name of the pool for the counts. It will be null if the pool is not specified in the request path.",
"type": "string"
},
"successCount": {
"description": "The number of canonical items in SUCCESS state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"archivedCount": {
"description": "The number of canonical items in ARCHIVED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"errorCount": {
"description": "The number of canonical items in ERROR state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"deletedCount": {
"description": "The number of canonical items in DELETED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
}
}
}
Secured by Basic_Authentication
Returns the addition for all pools of all status counts for canonical-publication items.
get /pools/{poolName}/status-counts/canonical-publication
Returns the addition for all pools of all status counts for canonical-publication items.
URI Parameters
- poolName: required (string)
Name of the pool
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/canonical-publication-item-status-counts#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "The status counts of all raw items per pool",
"properties": {
"poolName": {
"description": "The name of the pool for the counts. It will be null if the pool is not specified in the request path.",
"type": "string"
},
"successCount": {
"description": "The number of canonical-publication items in SUCCESS state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"internalErrorCount": {
"description": "The number of canonical-publication items set to FAILURE state due to Data Hub for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"externalErrorCount": {
"description": "The number of canonical-publication items set to FAILURE state due to the target system for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"ignoredCount": {
"description": "The number of canonical-publication items in IGNORED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
}
}
}
Secured by Basic_Authentication
Target Systems
Returns all target systems
get /target-systems
Returns all target systems
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned target-systems.
- pageSize: (integer - default: 50)
The size of a returned page of target-systems.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/target-systems#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "target-systems",
"description": "A collection of target systems",
"type": "array",
"items": "#/target-system"
}
Secured by Basic_Authentication
Target System Publications
Returns a page of target-system-publications
get /target-system-publications
Returns a page of target-system-publications
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned target-system-publications.
- pageSize: (integer - default: 50)
The size of a returned page of target-system-publications.
- q: (string)
Query string in lucene syntax. Supported terms are 'status' (0-many), startDate'(0-1), 'endDate'(0-1), 'poolName'(0-1), 'targetSystemName(0-1)'. Date format is [>,>=,<,<=]+'yyyyMMddHHmm'
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/target-system-publications#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "publication-actions",
"description": "A collection of target system publications",
"type": "array",
"items": "#/target-system-publication"
}
Secured by Basic_Authentication
Returns a particular target system publication by publication ID
get /target-system-publications/{publicationId}
Returns a particular target system publication by publication ID
URI Parameters
- publicationId: required (string)
The publication ID of the target system publication
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/target-system-publication#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A single target system publication",
"properties": {
"publicationId": {
"description": "ID of the target system publication",
"type": "integer"
},
"startTime" : {
"required" : false ,
"type" : "string"
} ,
"endTime" : {
"required" : false ,
"type" : "string"
} ,
"actionId": {
"description": "ID of the publication action",
"type": "integer"
},
"targetSystemName": {
"description": "The name of the target system being published to",
"type": "string"
},
"status": {
"description": "Status of this publication",
"enum": ["SUCCESS", "IN_PROGRESS", "COMPLETE_W_ERRORS", "FAILURE", "PENDING"]
},
"poolName" : {
"required" : false ,
"type" : "string"
},
"canonicalItemCount" : {
"required" : false ,
"type" : "number"
},
"internalErrorCount" : {
"required" : false ,
"type" : "number"
},
"externalErrorCount" : {
"required" : false ,
"type" : "number"
},
"ignoredCount" : {
"required" : false ,
"type" : "number"
}
},
"required": ["targetSystemName"]
}
Secured by Basic_Authentication
Returns all target system publication errors by publication ID
get /target-system-publications/{publicationId}/errors
Returns all target system publication errors by publication ID
URI Parameters
- publicationId: required (string)
The publication ID of the target system publication
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned errors.
- pageSize: (integer - default: 50)
The size of a returned page of errors.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/errors#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "Collection of errors returned from the target system",
"type": "array",
"items": "#/error"
}
Secured by Basic_Authentication
Returns all canonical item publication status items by publication ID
get /target-system-publications/{publicationId}/item-statuses
Returns all canonical item publication status items by publication ID
URI Parameters
- publicationId: required (string)
The publication ID of the target system publication
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned item-statuses.
- pageSize: (integer - default: 50)
The size of a returned page of item-statuses.
- q: (string)
Query string in lucene syntax. Supported terms are 'status' (0-many)
- status: (string)
A list of statuses to search for
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/canonicalItemPublicationStatusItemList#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "Collection of items returned from the target system",
"type": "array",
"items": "#/canonicalItemPublicationStatusItem"
}
Secured by Basic_Authentication
Returns all items by publication ID and type
get /target-system-publications/{publicationId}/items/{itemType}
Returns all items by publication ID and type
URI Parameters
- publicationId: required (string)
The publication ID of the target system publication
- itemType: required (string)
The type of item to be returned
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-items#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "item-type-definitions",
"description": "A collection of data items",
"type": "array",
"items": "#/item-type-definition"
}
Secured by Basic_Authentication
Item Classes
Returns all item classes
get /item-classes
Returns all item classes
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/item-classes#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "item-types",
"description": "A collection of all item classes",
"type": "array",
"items": "#/item-class"
}
Secured by Basic_Authentication
Returns all raw item types
get /item-classes/raw/item-types
Returns all raw item types
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/item-types#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "item-type-definitions",
"description": "A collection of type definitions extending a given base type",
"type": "array",
"items": "#/item-type-definition"
}
Secured by Basic_Authentication
Returns attributes by item type
get /item-classes/raw/item-types/{itemType}/attributes
Returns attributes by item type
URI Parameters
- itemType: required (string)
The type of item to be returned
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/raw-attribute-definitions#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "raw-attribute-definitions",
"description": "A collection of attribute definitions for a raw item type",
"type": "array",
"items": "#/raw-attribute-definition"
}
Secured by Basic_Authentication
Returns raw item attribute by item type and raw item attribute name
get /item-classes/raw/item-types/{itemType}/attributes/{attributeName}
Returns raw item attribute by item type and raw item attribute name
URI Parameters
- itemType: required (string)
The type of item to be returned
- attributeName: required (string)
Name of the raw item attribute
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/raw-attribute-definition#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "A raw attribute of a given raw item type",
"properties": {
"name": {
"description": "Name of the raw attribute",
"type": "string"
},
"itemType": {
"description": "Type of raw item",
"type": "string"
}
},
"required": ["name", "itemType"]
}
Secured by Basic_Authentication
Returns all canonical item types
get /item-classes/canonical/item-types
Returns all canonical item types
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/item-types#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "item-type-definitions",
"description": "A collection of type definitions extending a given base type",
"type": "array",
"items": "#/item-type-definition"
}
Secured by Basic_Authentication
Returns canonical item type by name
get /item-classes/canonical/item-types/{itemType}
Returns canonical item type by name
URI Parameters
- itemType: required (string)
ID of the canonical item type
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/item-type#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "Defines an item type extending a given base type",
"properties": {
"name": {
"description": "Name of the item type",
"type": "string"
}
}
}
Secured by Basic_Authentication
Returns all canonical item type attributes by item type
get /item-classes/canonical/item-types/{itemType}/attributes
Returns all canonical item type attributes by item type
URI Parameters
- itemType: required (string)
ID of the canonical item type
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/canonical-attribute-definitions#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "canonical-attribute-definitions",
"description": "A collection of attribute definitions for a canonical item type",
"type": "array",
"items": "#/canonical-attribute-definition"
}
Secured by Basic_Authentication
Returns canonical item attribute by item type and canonical item attribute name
get /item-classes/canonical/item-types/{itemType}/attributes/{attributeName}
Returns canonical item attribute by item type and canonical item attribute name
URI Parameters
- itemType: required (string)
ID of the canonical item type
- attributeName: required (string)
Name of the canonical item attribute
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/canonical-attribute-definition#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "Information defining the relationship between a canonical attribute and a raw attribute",
"properties": {
"name": {
"description": "Name of the canonical attribute",
"type": "string"
},
"itemType": {
"description": "The type of raw item this attribute is part of",
"type": "string"
},
"isCollection": {
"description": "Specifies if this attribute holds a collection of values",
"type": "boolean"
},
"isPrimaryKey": {
"description": "Specifies if this attribute is used as a primaryKey",
"type": "boolean"
},
"isSecured": {
"description": "Specifies if this attribute is secured",
"type": "boolean"
},
"isLocalizable": {
"description": "Specifies if this attribute is localizable",
"type": "boolean"
},
"type": {
"description": "Specifies the java type of this attribute",
"type": "string"
},
"transformations": {
"description": "Specifies the canonical transformations of this attribute",
"type": "canonicaltransformations"
}
},
"required": ["name", "itemType"]
}
Secured by Basic_Authentication
Raw Items
Returns raw item by item id
get /raw-items/{itemId}
Returns raw item by item id
URI Parameters
- itemId: required (integer)
ID of the raw item
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-item#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single data item",
"type": "object",
"properties": {
"type": {
"description": "Item type",
"type": "string"
},
"dataPool": {
"description": "name of the data pool",
"type": "string"
},
"id": {
"description": "Item id",
"type": "long"
},
"itemAttributeDataList": {
"description": "A collection of attributes about the item",
"type": "array",
"items": {
"properties": {
"name": {
"description": "Name of the attribute",
"type": "string"
},
"values": {
"description": "Values for the attribute. If the attribute is not localized, there should be one value in the collection",
"type": "array",
"items": {
"properties": {
"isoCode": {
"description": "Language of the attribute value",
"type": "string"
},
"value": {
"description": "Value of the given attribute. If the attribute is not a collection, there should be one value in the collection",
"type": "array",
"items" : "string"
}
}
}
}
}
}
},
"links": {
"description": "A collection of IDs for the item",
"type": "array",
"link": {
"properties": {
"rel": "Relationship of the association",
"href": "Link to the representation of the associated resource"
}
}
}
}
}
Secured by Basic_Authentication
Canonical Items
Returns canonical item by item id
get /canonical-items/{itemId}
Returns canonical item by item id
URI Parameters
- itemId: required (integer)
ID of the canonical item
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/data-item#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single data item",
"type": "object",
"properties": {
"type": {
"description": "Item type",
"type": "string"
},
"dataPool": {
"description": "name of the data pool",
"type": "string"
},
"id": {
"description": "Item id",
"type": "long"
},
"itemAttributeDataList": {
"description": "A collection of attributes about the item",
"type": "array",
"items": {
"properties": {
"name": {
"description": "Name of the attribute",
"type": "string"
},
"values": {
"description": "Values for the attribute. If the attribute is not localized, there should be one value in the collection",
"type": "array",
"items": {
"properties": {
"isoCode": {
"description": "Language of the attribute value",
"type": "string"
},
"value": {
"description": "Value of the given attribute. If the attribute is not a collection, there should be one value in the collection",
"type": "array",
"items" : "string"
}
}
}
}
}
}
},
"links": {
"description": "A collection of IDs for the item",
"type": "array",
"link": {
"properties": {
"rel": "Relationship of the association",
"href": "Link to the representation of the associated resource"
}
}
}
}
}
Secured by Basic_Authentication
Compositions
Returns all compositions
get /compositions
Returns all compositions
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned compositions.
- pageSize: (integer - default: 50)
The size of a returned page of compositions.
- q: (string)
Query string in lucene syntax. Supported terms are 'status' (0-many)
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/composition-actions#",
"$schema": "http://json-schema.org/draft-04/schema",
"title": "composition-actions",
"description": "A collection of data pool composition actions",
"type": "array",
"items": "#/composition"
}
Secured by Basic_Authentication
get /compositions/{compositionId}
URI Parameters
- compositionId: required (integer)
ID of the composition action
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/composition#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "A single composition action",
"type": "object",
"properties": {
"actionId": {
"description": "ID of the composition action",
"type": "integer"
},
"poolName": {
"description": "Name of the pool",
"type": "string"
},
"startTime": {
"description": "The timestamp for when the Composition action started",
"type": "datetime"
},
"endTime": {
"description": "The timestamp for when the Composition action ended",
"type": "datetime"
},
"type": {
"description": "Type of the pool action. Namly COMPOSITION",
"enum": ["COMPOSITION"]
},
"status": {
"description": "Composition status",
"enum": ["SUCCESS", "IN_PROGRESS", "FAILURE", "PENDING", "COMPLETE_W_ERRORS"]
},
"actionId": {
"description": "Count of canonical items created during the composition action",
"type": "integer"
}
},
"required": ["started"]
}
Secured by Basic_Authentication
Returns errors by composition action ID
get /compositions/{compositionId}/errors
Returns errors by composition action ID
URI Parameters
- compositionId: required (integer)
ID of the composition action
Query Parameters
- pageNumber: (integer - default: 0)
The page number of the returned errors.
- pageSize: (integer - default: 50)
The size of a returned page of errors.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/errors#",
"$schema": "http://json-schema.org/draft-04/schema",
"description": "Collection of errors returned from the target system",
"type": "array",
"items": "#/error"
}
Secured by Basic_Authentication
Extensions
Creates a new Data Hub extension based on the XML provided in the body. The XML should conform to datahub-metadata-schema-1.3.0.xsd
post /extensions
Creates a new Data Hub extension based on the XML provided in the body. The XML should conform to datahub-metadata-schema-1.3.0.xsd
Version
Status
Status Counts
Returns the addition for all pools of all status counts for all item types.
get /status-counts
Returns the addition for all pools of all status counts for all item types.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/item-status-counts#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "The status counts of all data types per pool",
"properties": {
"rawItemStatusCount": {
"description": "Status counts for all raw items grouped by pool if the request had a pool specified or the addition of all pools if no pool was specified",
"type": "raw-item-status-counts"
},
"canonicalItemStatusCount": {
"description": "Status counts for all canonical items grouped by pool if the request had a pool specified or the addition of all pools if no pool was specified",
"type": "canonical-item-status-counts"
},
"canonicalPublicationItemStatusCount": {
"description": "Status counts for all canonical item publications grouped by pool if the request had a pool specified or the addition of all pools if no pool was specified",
"type": "canonical-publication-item-status-counts"
}
}
}
Secured by Basic_Authentication
Returns the addition for all pools of all status counts for raw items.
get /status-counts/raw
Returns the addition for all pools of all status counts for raw items.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/raw-item-status-counts#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "The status counts of all raw items per pool",
"properties": {
"poolName": {
"description": "The name of the pool for the counts, or null if the pool is not specified in the request path",
"type": "string"
},
"ignoredCount": {
"description": "The number of raw items in IGNORED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"pendingCount": {
"description": "The number of raw items in PENDING state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"processedCount": {
"description": "The number of raw items in PROCESSED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
}
}
}
Secured by Basic_Authentication
Returns the addition for all pools of all status counts for canonical items.
get /status-counts/canonical
Returns the addition for all pools of all status counts for canonical items.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/canonical-item-status-counts#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "The status counts of all canonical items per pool",
"properties": {
"poolName": {
"description": "The name of the pool for the counts. It will be null if the pool is not specified in the request path.",
"type": "string"
},
"successCount": {
"description": "The number of canonical items in SUCCESS state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"archivedCount": {
"description": "The number of canonical items in ARCHIVED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"errorCount": {
"description": "The number of canonical items in ERROR state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"deletedCount": {
"description": "The number of canonical items in DELETED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
}
}
}
Secured by Basic_Authentication
Returns the addition for all pools of all status counts for canonical-publication items.
get /status-counts/canonical-publication
Returns the addition for all pools of all status counts for canonical-publication items.
HTTP status code 200
Body
Type: application/json
Schema:
{
"id": "/hybris/datahub/canonical-publication-item-status-counts#",
"$schema": "http://json-schema.org/draft-04/schema",
"type": "object",
"description": "The status counts of all raw items per pool",
"properties": {
"poolName": {
"description": "The name of the pool for the counts. It will be null if the pool is not specified in the request path.",
"type": "string"
},
"successCount": {
"description": "The number of canonical-publication items in SUCCESS state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"internalErrorCount": {
"description": "The number of canonical-publication items set to FAILURE state due to Data Hub for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"externalErrorCount": {
"description": "The number of canonical-publication items set to FAILURE state due to the target system for the pool, or the addition for all the pools if poolName is null",
"type": "long"
},
"ignoredCount": {
"description": "The number of canonical-publication items in IGNORED state for the pool, or the addition for all the pools if poolName is null",
"type": "long"
}
}
}