Custom Data Sources

The Mapp DMP supports using external data to enrich your reports. With this API you can forward the data directly without any human interaction.

Contents on this page

GET /api/manual-datasource

Description

List one / multiple data sources

Endpoint

/api/manual-datasource

Method

GET

The following query parameters can be used: 


ParametersDescription
idOptional. Place a custom data source ID here to get a single result.
columnsOptional, only available if "id" supplied. Add the columns to the result.
data

Optional, only available if "id" supplied. Add the data to the result. Options: 0, 1

limitOptional, only available if "data" = '1'. Is used to determine amount of rows per request (default=100, max=100).
pageOptional, only available if "data" = '1'. Is used to step through the list of data. First page starts at 1.
column_filterOptional, only available if "data" = '1'. Allows to only return a subset of columns. Comma separated.

PUT /api/manual-datasource

Description

Update a data source

Endpoint

/api/manual-datasource

Method

PUT

The following parameters can be used: 


ParametersDescription
idRequired.Custom data source ID.
payloadRequired. Set of mutations (see below)

Payload contents

JSON:

payload_mode: 'json',
payload: {
	"data": [{
		"column_key1": "value1",
		"column_key2": "value2"
	}]
}


Legacy:

The payload is a typical data parameter, supporting deletions, modifications and additions to the already existing data set. Please refer to the example below which removes 1 row, changes 1 column in another row, and adds 2 entirely new rows:

payload['deleted'][]=<row_id>&payload['changed'][<row_id>][<column_name_A>]=<value_A>&payload['added'][0][<column_name_A>]=<value_A>&payload['added'][0][<column_name_B>]=<value_B>&payload['added'][1][<column_name_A>]=<value_A>&payload['added'][1][<column_name_B>]=<value_B>