2. Public API Explorer
  3. Render Stories

Public API: Render Stories

Active
Zurück
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