HTTP API

The Container API is a standard REST API at http://cde-container-api (port 80). No authentication is needed — it's only accessible from inside the container environment. You can call it from any language using HTTP requests.

Each example below shows the PHP SDK equivalent alongside the raw HTTP request, so you can see what happens under the hood.

Write products to output

Used by data source connectors to import product data into the platform.

PHP SDK:

$this->containerApi->appendManyToOutputFile([
    ['id' => '1', 'name' => 'Product A', 'price' => '9.99'],
    ['id' => '2', 'name' => 'Product B', 'price' => '19.99'],
]);

HTTP:

curl -X POST http://cde-container-api/output/output \
  -H "Content-Type: application/json" \
  -d '{
    "data": [
      {"id": "1", "name": "Product A", "price": "9.99"},
      {"id": "2", "name": "Product B", "price": "19.99"}
    ]
  }'

Response (201):

{
  "message": "Written successfully."
}

The data field is an array of flat key-value objects. Each object represents one product. The optional meta.separator field controls how nested keys are flattened (default: -).

Endpoint reference: Write to output file

Read products from input

Used by export connectors to read all processed product data from the platform.

Read one product at a time

PHP SDK:

foreach ($this->containerApi->yieldFromInputFile() as $product) {
    // process $product
}

HTTP:

# Read the next product
curl http://cde-container-api/input/input/next

Response (200):

{
  "message": "",
  "data": {
    "id": "1",
    "name": "Product A",
    "price": "9.99"
  }
}

Each call returns one product and advances the cursor. When there are no more products, data is empty. Call /input/input/restart to reset the cursor.

Endpoint reference: Read input file

Read products in batches

PHP SDK:

foreach ($this->containerApi->yieldBatchFromInputFile(100) as $batch) {
    // process $batch (array of up to 100 products)
}

HTTP:

# Read a batch of 100 products
curl "http://cde-container-api/input/input/next_batch?size=100"

Response (200):

{
  "message": "",
  "data": [
    {"id": "1", "name": "Product A", "price": "9.99"},
    {"id": "2", "name": "Product B", "price": "19.99"}
  ]
}

Batch size must be between 1 and 999.

Endpoint reference: Read input file batch

Count items

PHP SDK:

$total = $this->containerApi->countItemsFromInputFile();

HTTP:

curl http://cde-container-api/items/input/count

Response (200):

{
  "message": "",
  "data": 1500
}

Endpoint reference: Items count

Read delta input

Used by export-delta connectors. Instead of a single input type, use new, modified, unchanged, or deleted.

PHP SDK:

foreach ($this->containerApi->yieldFromNewFile() as $product) { }
foreach ($this->containerApi->yieldFromModifiedFile() as $product) { }
foreach ($this->containerApi->yieldFromDeletedFile() as $product) { }

HTTP:

curl "http://cde-container-api/input/new/next_batch?size=100"
curl "http://cde-container-api/input/modified/next_batch?size=100"
curl "http://cde-container-api/input/deleted/next_batch?size=100"

The response format is the same as regular input. Replace input in the URL with the delta type.

Write feedback

Used by export and export-delta connectors to report the result of each product export back to the platform.

PHP SDK:

$this->containerApi->appendToFeedbackFile([
    'id' => $product['id'],
    'status' => 'success',
]);

// Or in bulk
$this->containerApi->appendManyToFeedbackFile([
    ['id' => '1', 'status' => 'success'],
    ['id' => '2', 'status' => 'error', 'message' => 'Invalid SKU'],
]);

HTTP:

curl -X POST http://cde-container-api/output/feedback \
  -H "Content-Type: application/json" \
  -d '{
    "data": [
      {"id": "1", "status": "success"},
      {"id": "2", "status": "error", "message": "Invalid SKU"}
    ]
  }'

Response (201):

{
  "message": "Written successfully."
}

Feedback is imported as an additional data source on the next site run, so end-users can see which products succeeded or failed.

Endpoint reference: Write to output file (feedback uses the same endpoint with type feedback)

Log messages

Log messages appear in the Dev Portal monitoring.

PHP SDK:

$this->containerApi->info('Import started.');
$this->containerApi->warning('Skipped 3 products with missing IDs.');
$this->containerApi->error('API returned 503, retrying...');

HTTP:

# Log levels: debug, info, notice, warning, error, critical, alert, emergency
curl -X POST http://cde-container-api/activity/logs/info \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Import started.",
    "context": {}
  }'

Response (201):

{
  "message": "success"
}

The context field is optional — use it to attach structured data to the log entry.

Endpoint reference: Add log

Send notifications

Notifications appear in the end-user's notification panel on the Productsup platform.

PHP SDK:

$this->containerApi->sendNotification('info', 'Export completed successfully.');

HTTP:

# Notification levels: info, notice, warning, error, success
curl -X POST http://cde-container-api/activity/notifications/info \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Export completed successfully.",
    "context": {}
  }'

Response (201):

{
  "message": "success"
}

Endpoint reference: Add notification

Health check

Verify the Container API is running and ready.

curl http://cde-container-api/ping

Response (200):

{
  "message": "pong"
}

Endpoint reference: Ping

Error responses

All error responses follow the same format:

{
  "message": "Validation failed",
  "errors": {
    "field_name": "Error description"
  }
}

Status	Meaning
`201`	Write successful
`200`	Read successful
`400`	Invalid request — check the `errors` object
`404`	File not found — wrong input type for your connector type
`409`	Output file size limit exceeded
`429`	Rate limit exceeded (logs or notifications)
`500`	Internal server error

See Troubleshooting for detailed fixes for each error.

Generating a typed client

The Container API publishes an OpenAPI specification. You can generate a typed client in any language using tools like OpenAPI Generator or oapi-codegen (Go).

For the full endpoint reference, see API Reference.

HTTP API

On this page