Order Images

To order images using the RAPI, a POST request is submitted containing the following JSON (as an example):

{
    "destinations": [],
    "items": [
        {
            "collectionId": "RCMImageProducts",
            "recordId": "7822244",
            "parameters": [
                {
                    "packagingFormat": "TAR"
                },
                {
                    "NOTIFICATION_EMAIL_ADDRESS": "example@email.com"
                }
            ]
        }
    ]
}

So, ordering images using the EODMSRAPI requires a list of results (items) and optional priority, parameters and destinations values.

Results

The results parameter can be a list of results returned from a search session or a list of items. The results is required.

Each item must have: recordId collectionId

Priority

The priority can be a single string entry (“Low”, “Medium”, “High”, or “Urgent”) which will be applied to all images or a list of dictionaries containing recordId and priority value for each individual image. The priority is optional and the default is “Medium”.

Parameters

The parameters can be a list of parameter dictionaries which will be applied to all images or a list of dictionaries containing the recordId and parameters.

Each item in the parameters list should be the same as how it appears in the POST request (ex: {"packagingFormat": "TAR"})

You can get a list of available parameters by calling the get_order_parameters method of the EODMSRAPI, submitting arguments collection and recordId. The parameters is optional.

Destinations

The destinations is a list of destination dictionaries containing a set of items. There are 2 types of destinations, “FTP” and “Physical”.

The “FTP” dictionary would look something like this:

{
    "type": "FTP",
    "name": "FTP Name",
    "hostname": "ftp://ftpsite.com",
    "username": "username",
    "password": "password",
    "stringValue": "ftp://username@ftpsite.com/downloads",
    "path": "downloads",
    "canEdit": "false"
}

The “Physical” dictionary would look like this:

{
    "type": "Physical",
    "name": "Destination Name",
    "customerName": "John Doe",
    "contactEmail": "example@email.com",
    "organization": "Organization Name",
    "phone": "555-555-5555",
    "addr1": "123 Fake Street",
    "addr2": "Optional",
    "addr3": "Optional",
    "city": "Ottawa",
    "stateProv": "Ontario",
    "country": "Canada",
    "postalCode": "A1A 1A1",
    "classification": "Optional"
}

For more information on the destination items, visit Directly Accessing the EODMS REST API.

Example

Here’s an example of how to submit an order to the EODMSRAPI using the previous search session:

params = [{"packagingFormat": "TAR"}]

order_res = rapi.order(res, priority="low", parameters=params)