Import

Operations for imports

Start Customer-Specific Info import

post

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
cacheFlushbooleanOptional

if true: causes a cache flush after a channel has been imported

Default: false
channelstring[]Optional
downloadbooleanOptional

if true: causes the import file to be updated first. If no URL is stored in the FACT-Finder configuration, this parameter has no effect.

Default: false
importStagestring · enumOptional

IMPORT_ONLY only fills the intermediate DB, LOAD_ONLY imports that database into memory, and FULL combines both stages

Default: FULLPossible values:
quietbooleanOptional

if true: only receive a filled response if an error occurs during the import otherwise the response is just empty

Default: false
Responses
chevron-right
200

OK

application/json
channelstringRequired

The channel for which the import was performed.

durationInSecondsinteger · int64Required

The duration of the import process (seconds).

errorMessagesstring[]Required

Import error messages.

importTypestring · enumRequired

The type of data imported.

Possible values:
importedFieldsinteger · int32Required

The number of fields imported.

importedRecordsinteger · int32Optional

The number of records imported.

importedWorldmatchDocumentsinteger · int32Optional

The number of records imported into worldmatch.

startDatestring · date-timeRequired

The time and date that the import was started.

statusMessagesstring[]Required

Import status messages.

post
/rest/v5/import/customerprices

Start embedding import

post

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
channelstring[]Optional
quietbooleanOptional

if true: only receive a filled response if an error occurs during the import otherwise the response is just empty

Default: false
Responses
chevron-right
200

OK

application/json
channelstringRequired

The channel for which the import was performed.

durationInSecondsinteger · int64Required

The duration of the import process (seconds).

errorMessagesstring[]Required

Import error messages.

importTypestring · enumRequired

The type of data imported.

Possible values:
importedFieldsinteger · int32Required

The number of fields imported.

importedRecordsinteger · int32Optional

The number of records imported.

importedWorldmatchDocumentsinteger · int32Optional

The number of records imported into worldmatch.

startDatestring · date-timeRequired

The time and date that the import was started.

statusMessagesstring[]Required

Import status messages.

post
/rest/v5/import/embedding

Start geo import

post

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
cacheFlushbooleanOptional

if true: causes a cache flush after a channel has been imported

Default: false
channelstring[]Optional
downloadbooleanOptional

if true: causes the import file to be updated first. If no URL is stored in the FACT-Finder configuration, this parameter has no effect.

Default: false
importStagestring · enumOptional

IMPORT_ONLY only fills the intermediate DB, LOAD_ONLY imports that database into memory, and FULL combines both stages

Default: FULLPossible values:
quietbooleanOptional

if true: only receive a filled response if an error occurs during the import otherwise the response is just empty

Default: false
Responses
chevron-right
200

OK

application/json
channelstringRequired

The channel for which the import was performed.

durationInSecondsinteger · int64Required

The duration of the import process (seconds).

errorMessagesstring[]Required

Import error messages.

importTypestring · enumRequired

The type of data imported.

Possible values:
importedFieldsinteger · int32Required

The number of fields imported.

importedRecordsinteger · int32Optional

The number of records imported.

importedWorldmatchDocumentsinteger · int32Optional

The number of records imported into worldmatch.

startDatestring · date-timeRequired

The time and date that the import was started.

statusMessagesstring[]Required

Import status messages.

post
/rest/v5/import/geo

Start ranking import

post

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
cacheFlushbooleanOptional

if true: causes a cache flush after a channel has been imported

Default: false
channelstring[]Optional
quietbooleanOptional

if true: only receive a filled response if an error occurs during the import otherwise the response is just empty

Default: false
Responses
chevron-right
200

OK

application/json
channelstringRequired

The channel for which the import was performed.

durationInSecondsinteger · int64Required

The duration of the import process (seconds).

errorMessagesstring[]Required

Import error messages.

importTypestring · enumRequired

The type of data imported.

Possible values:
importedFieldsinteger · int32Required

The number of fields imported.

importedRecordsinteger · int32Optional

The number of records imported.

importedWorldmatchDocumentsinteger · int32Optional

The number of records imported into worldmatch.

startDatestring · date-timeRequired

The time and date that the import was started.

statusMessagesstring[]Required

Import status messages.

post
/rest/v5/import/ranking

Start recommendation import

post

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
channelstring[]Optional
quietbooleanOptional

if true: only receive a filled response if an error occurs during the import otherwise the response is just empty

Default: false
Responses
chevron-right
200

OK

application/json
channelstringRequired

The channel for which the import was performed.

durationInSecondsinteger · int64Required

The duration of the import process (seconds).

errorMessagesstring[]Required

Import error messages.

importTypestring · enumRequired

The type of data imported.

Possible values:
importedFieldsinteger · int32Required

The number of fields imported.

importedRecordsinteger · int32Optional

The number of records imported.

importedWorldmatchDocumentsinteger · int32Optional

The number of records imported into worldmatch.

startDatestring · date-timeRequired

The time and date that the import was started.

statusMessagesstring[]Required

Import status messages.

post
/rest/v5/import/recommendation

Refresh recommendation databases

post

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
channelstring[]Optional
Responses
chevron-right
200

OK

No content

post
/rest/v5/import/refreshRecommendations

No content

Check if an import is running in any of the supplied channels

get

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
channelstring[]Required
Responses
chevron-right
200

OK

application/json
booleanOptional
get
/rest/v5/import/running

Start search import

post

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
cacheFlushbooleanOptional

if true: causes a cache flush after a channel has been imported

Default: false
channelstring[]Optional
downloadbooleanOptional

if true: causes the import file to be updated first. If no URL is stored in the FACT-Finder configuration, this parameter has no effect.

Default: false
importStagestring · enumOptional

IMPORT_ONLY only fills the intermediate DB, LOAD_ONLY imports that database into memory, and FULL combines both stages

Default: FULLPossible values:
includeCustomerPricesbooleanOptional

if true: executes a Customer-Specific Info import after the search import. If Customer-Specific Info is not enabled for a given channel, this parameter has no effect.

Default: false
includeGeobooleanOptional

if true: executes a geo import after the search import. If the geo module is not enabled for a given channel, this parameter has no effect.

Default: false
quietbooleanOptional

if true: only receive a filled response if an error occurs during the import otherwise the response is just empty

Default: false
Responses
chevron-right
200

OK

application/json
channelstringRequired

The channel for which the import was performed.

durationInSecondsinteger · int64Required

The duration of the import process (seconds).

errorMessagesstring[]Required

Import error messages.

importTypestring · enumRequired

The type of data imported.

Possible values:
importedFieldsinteger · int32Required

The number of fields imported.

importedRecordsinteger · int32Optional

The number of records imported.

importedWorldmatchDocumentsinteger · int32Optional

The number of records imported into worldmatch.

startDatestring · date-timeRequired

The time and date that the import was started.

statusMessagesstring[]Required

Import status messages.

post
/rest/v5/import/search

Start suggest import

post

Required Roles: ApiImport

Authorizations
AuthorizationstringRequired
Query parameters
channelstring[]Optional
quietbooleanOptional

if true: only receive a filled response if an error occurs during the import otherwise the response is just empty

Default: false
Responses
chevron-right
200

OK

application/json
channelstringRequired

The channel for which the import was performed.

durationInSecondsinteger · int64Required

The duration of the import process (seconds).

errorMessagesstring[]Required

Import error messages.

importTypestring · enumRequired

The type of data imported.

Possible values:
importedFieldsinteger · int32Required

The number of fields imported.

importedRecordsinteger · int32Optional

The number of records imported.

importedWorldmatchDocumentsinteger · int32Optional

The number of records imported into worldmatch.

startDatestring · date-timeRequired

The time and date that the import was started.

statusMessagesstring[]Required

Import status messages.

post
/rest/v5/import/suggest

Last updated

Was this helpful?