Am Sonntag, den 23.08.2026 führen wir zwischen 21:00 - 23:00 Uhr Wartungsarbeiten durch. Zum Zeitpunkt laufende Datei-Uploads und Jobs können unter Umständen unterbrochen werden. OXOMI Portale und alle Services arbeiten normal weiter, es besteht kein Handlungsbedarf.
Provides services for rendering stories.
Render Searchlet Story
Tries to find and render a searchlet for the given parameters.
POST
JSON
/portals/api/v1/stories/render-searchlet
Parameters
| Name | Description | Example | |
|---|---|---|---|
|
accessToken
Required
|
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. | d0765f518ff0cab426dbbd6d467c9967 | |
|
portal
Required
|
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. | 9999999 | |
|
user
Required
|
User name | john.doe | |
| brandName | Specifies the brand name to filter by. This is just a backup option, and a unique supplier number should preferably be used instead. | ACME | |
| classification | Specifies the ETIM class to filter by. | ec011550 | |
| filterCountry | The country to filter by. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. | de | |
| filterLanguage | The language to filter by in case of multi language portals. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. | de | |
| language | Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. | de | |
| productGroup | Specifies the product group as supplied by the manufacturer to filter by. | pg-01 | |
| query | Specifies the current search query of the user to filter by. | bathtub | |
| roles | Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. | Heating,Electronics,Top-Customer | |
| seriesCode | Specifies the series code as supplied by the manufacturer to filter by. | 001 | |
| supplierNumber | Specifies the number of the supplier to filter by, as set in the respective partnership. This is the preferred way to specify the supplier. | 0815 | |
Requests
| Description | Example |
|---|---|
|
Sample request
Content-Type:
application/json
|
{
"portal": "DEMO",
"user": "Demouser",
"roles": "sales",
"accessToken": "fc97df375de49fbae114a42a991c5999",
"lang": "de",
"filterLang": "de",
"brandName": "ACME",
"supplierNumber": "0815",
"classification": "ec011550",
"seriesCode": "001",
"productGroup": "pg-01",
"query": "bathtub"
}
|
Responses
| Description | Example |
|---|---|
|
200
Successful response
Content-Type:
application/json
|
{
"success": true,
"error": false,
"renderedHtml": "<div class=\"sci-border-box sci-story sci-story-gc8hheij92rnsgh2\">...</div>",
"borderless": false
}
|
|
400
Missing parameter or malformed request
Content-Type:
application/json
|
{
"success": false,
"error": true,
"message": "The parameter {missingParameter} must be filled."
}
|
|
401
Authentication required but none provided
Content-Type:
application/json
|
|
|
403
Invalid authentication or missing permission
Content-Type:
application/json
|
|
|
404
Resource not found
Content-Type:
application/json
|
|
|
405
Incorrect request method, e.g. GET instead of POST
Content-Type:
application/json
|
|
|
500
Unexpected server-side error
Content-Type:
application/json
|
Render Stories Slider
Renders a slider containing all accessible stories and returns the generated html within a json response.
POST
JSON
/portals/api/v1/stories/slider
Parameters
| Name | Description | Example | |
|---|---|---|---|
|
accessToken
Required
|
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. | d0765f518ff0cab426dbbd6d467c9967 | |
|
limit
Required
|
Defines the maximum number of stories within the slider (Max: 10). | ||
|
portal
Required
|
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. | 9999999 | |
|
user
Required
|
User name | john.doe | |
| filterCountry | The country to filter by. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. | de | |
| filterLanguage | The language to filter by in case of multi language portals. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. | de | |
| language | Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. | de | |
| roles | Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. | Heating,Electronics,Top-Customer | |
Requests
| Description | Example |
|---|---|
|
Sample request
Content-Type:
application/json
|
{
"limit": "6",
"portal": "DEMO",
"user": "Demouser",
"roles": "sales",
"accessToken": "25ca3e75b592585d7748a189ab10d8c3",
"lang": "",
"interactionToken": "8wjlnm0ydq2demo"
}
|
Responses
| Description | Example |
|---|---|
|
200
Successful response
Content-Type:
application/json
|
{
"success": "true",
"error": false,
"renderedHtml": "<div class=\"sci-border-box sci-story sci-story-gc8hheij92rnsgh2\">...</div>"
}
|
|
400
Missing parameter or malformed request
Content-Type:
application/json
|
{
"success": false,
"error": true,
"message": "The parameter {missingParameter} must be filled."
}
|
|
401
Authentication required but none provided
Content-Type:
application/json
|
|
|
403
Invalid authentication or missing permission
Content-Type:
application/json
|
|
|
404
Resource not found
Content-Type:
application/json
|
|
|
405
Incorrect request method, e.g. GET instead of POST
Content-Type:
application/json
|
|
|
500
Unexpected server-side error
Content-Type:
application/json
|
Render Story
Renders the requested story and returns the generated HTML within a JSON response.
POST
JSON
/portals/api/v1/stories/render
Parameters
| Name | Description | Example | |
|---|---|---|---|
|
accessToken
Required
|
Access token for non-public portals. When submitting a user or roles, the respective values need to be considered during the computation of the token. See Authentifizierung for details. | d0765f518ff0cab426dbbd6d467c9967 | |
|
portal
Required
|
Globally unique alpha-numeric code as set up or automatically assigned. Also visible in the respective URL on the Portals page. | 9999999 | |
|
story
Required
|
The id of the desired story or its manually (and optionally) provided code. If multiple stories with the same code exists, the newest will be selected. | demostory-1 | |
|
user
Required
|
User name | john.doe | |
| filterCountry | The country to filter by. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. | de | |
| filterLanguage | The language to filter by in case of multi language portals. Provide a two-letter ISO code. Note that internationalisation is a paid feature that needs to be purchased and enabled separately. | de | |
| language | Language to use for human-readable data. Does not affect content where applicable. Provide a two-letter ISO code. | de | |
| roles | Comma-separated list of roles assigned to the user. Can be omitted if roles are not in use, or if the portal is public. | Heating,Electronics,Top-Customer | |
Requests
| Description | Example |
|---|---|
|
Sample request
Content-Type:
application/json
|
{
"story": "demostory-1",
"portal": "DEMO",
"user": "Demouser",
"roles": "sales",
"accessToken": "fc97df375de49fbae114a42a991c5999",
"lang": "de",
"filterLang": "de"
}
|
Responses
| Description | Example |
|---|---|
|
200
Successful response
Content-Type:
application/json
|
{
"success": true,
"error": false,
"id": "51",
"code": "demostory-1",
"type": "landingpage",
"typeName": "Landingpage",
"renderedHtml": "<div class=\"sci-border-box sci-story sci-story-gc8hheij92rnsgh2\">...</div>"
}
|
|
400
Missing parameter or malformed request
Content-Type:
application/json
|
{
"success": false,
"error": true,
"message": "The parameter {missingParameter} must be filled."
}
|
|
401
Authentication required but none provided
Content-Type:
application/json
|
|
|
403
Invalid authentication or missing permission
Content-Type:
application/json
|
|
|
404
Resource not found
Content-Type:
application/json
|
|
|
405
Incorrect request method, e.g. GET instead of POST
Content-Type:
application/json
|
|
|
500
Unexpected server-side error
Content-Type:
application/json
|