Request - JSON

The API support JSON formatted responses.

This solution puts higher requirements on the integration since the data isn't formatted. It means you have to handle the locale, percent formation, signs for positives/negatives and so on.

Get widget

GET https://widget.datablocks.se/api/rose/widgets/:widgetType?token=:tokenId&type=json

Get JSON formatted data (The response is an example of the owner-list)

Path Parameters

Name	Type	Description
widgetType*	string	Specific widget (example: owner-list)

Query Parameters

Name	Type	Description
token*	string	Credential provided by MF, specific for each widget

Example

200 Widget recieved

{
    "numOfOwners": 61430,
    "numOfOwnersDate": "2018-12-31",
    "numOfShares": 455351068,
    "numOfSharesDate": "2018-12-31",
    "ownerSum": [
        {
        "capital": 0.40042998208142994,
        "holdingDate": "",
        "numOfShares": 182336220,
        "ownerName": "Total 10",
        "votes": 0.472891015466023
        }
    ],
    "owners": [
        {
        "capital": 0.13821456766628248,
        "holdingDate": "2018-12-31",
        "numOfShares": 62936151,
        "ownerName": "FAM AB",
        "votes": 0.2876165162710123
        },
        {
        "capital": 0.07044806140654533,
        "holdingDate": "2018-12-31",
        "numOfShares": 32078600,
        "ownerName": "Harris Associates",
        "votes": 0.04245709733515821
        },
        {
        "capital": 0.037131596230273914,
        "holdingDate": "2018-12-31",
        "numOfShares": 16907912,
        "ownerName": "Didner & Gerge Fonder",
        "votes": 0.02238059890896779
        }
    ]
}

500 The data is corrupted.

{
    "message": "Internal server error"
}

Calendar - JSON

In JSON-integration, the data that is used to build the calendar is provided. Note that this means that you have to handle logic like deciding when to show the end date of an event (presumably based on the includeEnd field), whether to show times (based on the includeTime field), how to format everything, and so on. Language selection and time locale are, however, handled by the backend.

The JSON API is located at https://widget.datablocks.se/proxy/calendar/:widgetId/:language

IMPORTANT: timeLocation and languageFallback should be provided as query parameters (The backend will default to UTC and false respectively if they are not provided or not correct).

Thus, a typical request might look like:

https://widget.datablocks.se/proxy/calendar/<widgetId>/fi?time-location=Europe/Helsinki&languageFallback=false

Other available integration methods

• Request - HTML
• JS-loader