Skip to content
Public API
/
Logs Management
/
Store log messages

Omnia 2.0 API (0.0.7213)

This is the API powering Omnia 2.0 and Pricemonitor, containing operations that can also be used directly by customers from their own systems.

The Omnia 2.0 API is RESTful and provides access to the backend of Omnia 2.0 and Pricemonitor. It is used to manage products, offers, contracts, and more.

This API supports both public endpoints for customer integration and internal endpoints for platform management. All endpoints are authenticated using either Basic Authentication or JWT Bearer tokens.

Download OpenAPI description
omnia.json
omnia.yaml
Overview
URL

https://www.omniaretail.com/

License

Omnia Retail API license

Languages
Servers
Mock server

https://api-docs.omniaretail.dev/_mock/api/omnia/

Production API

https://api.patagona.de/

Overview

Overview, explanation and pointers to the API documentation.

Products Management

Operations to manage your products.

Operations

Price Recommendations

Operations to get price recommendations calculated by our system.

Operations

Offers

Operations to get and manage offers.

Operations

Feeds Management

Manage your data-feeds.

Operations

Logs Management

Operations to store log messages in the system.

You can integrate this API into your own system and publish integration logs to the system so that Omnia Retail can analyze them.

Operations

Store log messages

Request

Stores log messages in the platform. This endpoint aims to improve the API integration process.

Security
BasicAuth or BearerAuth
Bodyapplication/jsonrequired
versionstringrequired

API version for log message format. Must always be "1" for current implementation.

Value"1"
Example: "1"
messagesArray of objects(LogMessage)[ 1 .. 1000 ] itemsrequired

Array of log messages to be processed

messages[].​messagestring[ 1 .. 5000 ] charactersrequired

The actual log message content to be published

Example: "Product sync completed successfully"
messages[].​severitystringrequired

Log message severity level, ordered by priority (highest to lowest):

  • fatal: Critical errors causing system termination
  • error: Serious errors requiring immediate attention
  • warn: Deprecated APIs, poor API usage, or unexpected situations
  • info: General progress and state information for end users
  • debug: Detailed information for application developers and support
  • trace: Most detailed information for deep debugging
Enum"fatal""error""warn""info""debug""trace"
Example: "info"
messages[].​componentstring[ 1 .. 100 ] charactersrequired

Name of the integrated system or application component generating the log

Example: "shopware"
messages[].​sourcestring[ 1 .. 255 ] charactersrequired

Specific entity or source within the component for additional categorization

Example: "shop.example.com"
messages[].​contractIdstringnon-empty

The contract identifier associated with this log message

Example: "qbcxvb"
curl -i -X POST \
  -u <username>:<password> \
  https://api-docs.omniaretail.dev/_mock/api/omnia/api/v3/log/messages \
  -H 'Content-Type: application/json' \
  -d '{
    "version": "1",
    "messages": [
      {
        "message": "Product sync completed successfully",
        "severity": "info",
        "component": "shopware",
        "source": "shop.example.com",
        "contractId": "qbcxvb"
      }
    ]
  }'

Responses

The logs have been stored successfully.

Company Management

Operations for managing company entities, including creation, retrieval, and contract management.

Operations

Orders Management

Operations for managing orders, including bulk order imports and order tracking.

Operations

Settings Management

Operations to manage the settings of contracts. Only a limited number of these operations are available to customers directly.

Operations

Tasks Management

Operations to view and manage the tasks running in the platform. Customers can only view tasks.

Operations

Strategies Management

Operations to view and manage pricing strategies.

Operations

Domains

Operations to view all supported domains.

A domain is an external datasource or website that contains information about offers for products for sale. Information like product characteristics and sales characterics like price, stock level and delivery times and costs.

Operations

Plugin Registration

Operations to view and manage registered plugins for system integration.

Operations