Use the Search the catalog by host name endpoint that allows searching among all data hosts as follows:
- Call the Get data hosts endpoint and choose a data host. Retrieve the name of the chosen data host from the
data.content.name
field.
- Use the chosen name as the
{host_name}
path parameter to call the Search the catalog by host name endpoint.
The URL path of the Estimate a catalog order cost endpoint hasn't changed, but the request body schema is updated. Create a request body as follows:
- Call the Get data products endpoint and choose a data product. Retrieve the following values:
- From
data.content.id
: the ID of the chosen data product.
- From
data.productConfiguration.hostName
: the data host name.
- Use the chosen ID as the
{data_product_id}
path parameter to call the Get a JSON schema of an order form endpoint. It will provide you with the format for a future order estimation request.
- Use the data host name as the
{host_name}
path parameter to call the Search the catalog by host name endpoint and choose a scene. Retrieve the ID of the chosen scene from the features.properties.id
field.
- Create a request body for the Estimate a catalog order cost endpoint:
- For the
dataProduct
parameter, use the chosen data product ID.
- For the
params
object, use the required request body schema format for the chosen data product.
- For the
params.id
parameter, use the chosen scene ID.
{
"dataProduct": "b1f8c48e-d16b-44c4-a1bb-5e8a24892e69", // The data product ID
"params": {
"id": "42712243-a45c-4c8e-adfa-1ce01d27b718", // The scene ID
<...> // The format of the payload is different for different data products
}
}
The URL path of the Create an order endpoint hasn't changed, but the request body schema is updated. Create a request body as follows:
- Call the Get data products endpoint and choose a data product. Retrieve the following values:
- From
data.content.id
: the ID of the chosen data product.
- From
data.productConfiguration.hostName
: the data host name.
- Use the chosen ID as the
{data_product_id}
path parameter to call the Get a JSON schema of an order form endpoint. It will provide you with the format for a future order creation request.
If you place a catalog order
- Use the data host name as the
{host_name}
path parameter to call the Search the catalog by host name endpoint and choose a scene. Retrieve the ID of the chosen scene from the features.properties.id
field.
- Create a request body for the Create an order endpoint:
- For the
dataProduct
parameter, use the chosen data product ID.
- For the
params
object, use the required request body schema format for the chosen data product.
- For the
params.id
parameter, use the chosen scene ID.
If you place a tasking order
- Create a request body for the Create an order endpoint:
- For the
dataProduct
parameter, use the chosen data product ID.
- For the
params
object, use the required request body schema format for the chosen data product.
{
"dataProduct": "b1f8c48e-d16b-44c4-a1bb-5e8a24892e69", // The data product ID
"params": {
"id": "42712243-a45c-4c8e-adfa-1ce01d27b718", // If needed, the scene ID
<...> // The format of the payload is different for different data products
}
}