Custom Connector
Malaysia Open Data Catalogue Connector
Malaysia
The Malaysia Open Data Catalogue Connector facilitates seamless integration with the Malaysia Data Catalogue API, provided by the Malaysia Open Data Portal, offering access to datasets hosted on data.gov.my. This includes general datasets via the Data Catalogue endpoint and OpenDOSM-specific datasets for economic and statistical data, with filtering and limiting in JSON.
Overview
Integration Overview
This document provides a detailed guide for each integration point, its purpose, configuration, and workflow support using the Malaysia Data Catalogue API Connector.
- getDataCatalogue. Retrieve data from the general Data Catalogue.
- getOpenDOSMData. Retrieve data from the OpenDOSM Data Catalogue.
Documentation
Detailed Integration Documentation
Get Data Catalogue Retrieval
| Action | getDataCatalogue |
|---|---|
| Purpose | Retrieves data from a specified dataset in the general Data Catalogue (e.g. fuel prices or demographic data), with flexible filtering and limiting. |
| Configuration | Configure the base URL via CONNECTOR_ENV_MALAYSIADATACATALOGUEAPI_BASE_URL. |
| Parameters | Required: id — unique dataset identifier (e.g. fuelprice). Optional: limit (integer, min 1, e.g. 3); contains — filter by a value in a column (e.g. somevalue@column_name). |
| Output | Successful: JSON array of dataset records with a dynamic structure based on the dataset’s metadata (e.g. for fuelprice: date, price). Failure: 400 invalid/missing id, 404 dataset not found, 500 server error. |
| Workflow example | Execute getDataCatalogue with id=fuelprice and limit=3, then display fuel-price trends in a dashboard. |
Get OpenDOSM Data Retrieval
| Action | getOpenDOSMData |
|---|---|
| Purpose | Retrieves data from OpenDOSM-specific datasets (e.g. Core CPI or economic indicators), with filtering and limiting for statistical analysis. |
| Configuration | Configure the base URL via CONNECTOR_ENV_MALAYSIADATACATALOGUEAPI_BASE_URL. |
| Parameters | Required: id — unique OpenDOSM dataset identifier (e.g. cpi_core). Optional: limit (integer, min 1, e.g. 3); contains — filter by a value in a column. |
| Output | Successful: JSON array of dataset records with a dynamic structure (e.g. for cpi_core: date, index). Failure: 400/404/500. |
| Workflow example | Execute getOpenDOSMData with id=cpi_core and limit=5, then integrate Core CPI data into a financial forecasting tool. |
Example Workflow: Economic & Consumer Insights
| Retrieve fuel prices | Use getDataCatalogue with id=fuelprice to fetch recent fuel-price data and visualize trends. |
|---|---|
| Fetch economic indicators | Execute getOpenDOSMData with id=cpi_core to retrieve Core CPI, correlating inflation with fuel costs. |
| Apply filters | Use the contains parameter to filter by region or category (e.g. Kuala Lumpur@location). |
Support
For technical support, contact custom-connectors-support@isolutions.sa.