Update data for several keys

Post or update data for multiple keys.

Kameleoon rejects an incoming request if the source is a bot or spider, based on IAB/ABC user-agent filtering rules. Kameleoon uses a single-pass method. You don’t need to take specific action when sending requests from a web browser using a standard library (XHR). However, in other cases, set a custom value for the User-Agent request header to overwrite the default value the library sets.

POST /map/maps

Update data for several keys

cURL

curl --request POST \
  --url https://eu-data.kameleoon.io/map/maps \
  --header 'Content-Type: application/json' \
  --header 'user-agent: <user-agent>' \
  --data '"<string>"'

import requests

url = "https://eu-data.kameleoon.io/map/maps"

payload = "<string>"
headers = {
    "user-agent": "<user-agent>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'user-agent': '<user-agent>', 'Content-Type': 'application/json'},
  body: JSON.stringify('<string>')
};

fetch('https://eu-data.kameleoon.io/map/maps', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://eu-data.kameleoon.io/map/maps",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode('<string>'),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "user-agent: <user-agent>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://eu-data.kameleoon.io/map/maps"

	payload := strings.NewReader("\"<string>\"")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("user-agent", "<user-agent>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://eu-data.kameleoon.io/map/maps")
  .header("user-agent", "<user-agent>")
  .header("Content-Type", "application/json")
  .body("\"<string>\"")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://eu-data.kameleoon.io/map/maps")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["user-agent"] = '<user-agent>'
request["Content-Type"] = 'application/json'
request.body = "\"<string>\""

response = http.request(request)
puts response.read_body

Headers

user-agent · string · default: kameleoon-docs · required

Not always required. Kameleoon rejects an incoming request if the source is a bot or spider, based on IAB/ABC user-agent filtering rules. Kameleoon uses a single-pass method. You don't need to take specific action when sending requests from a web browser using a standard library (XHR). However, in other cases, set a custom value for the User-Agent request header to overwrite the default value the library sets.

Query Parameters

siteCode · string · required

The Kameleoon project ID.

ttlHours · integer<int32> · default: 2208

The time-to-live in hours. The maximum value is 8784 (366 days).

Body

application/json

Save maps. The body size limit is 1 MB.

A JSON object { "<key>": <map> }, where <map> is a JSON object { "<field name>": <field value> }.

Limit every <key> to 100 characters.
Limit every <field name> to 1024 characters.

Body example with a "pretty" representation (not recommended):

{
 	"keyToUpdate": {
		"field1": "newStringValue",
		"field2": [
			"newArrayValueElement1",
			"newArrayValueElement2"
		]
	},
	"keyToDelete": {
	},
	"someVisitorCode": {
		"someMapProperty": {
			"name1": 0,
			"name2": [
				"a",
				"b",
				"c"
			]
		},
		"someBooleanProperty": true,
		"someNumberProperty": 25
	}
}

Body example with a "compact" representation (recommended):

{"keyToUpdate":{"field1":"newStringValue","field2":["newArrayValueElement1","newArrayValueElement2"]},"keyToDelete":{},"someVisitorCode":{"someMapProperty":{"name1":0,"name2":["a","b","c"]},"someBooleanProperty":true,"someNumberProperty":25}}

The body is of type string<UTF-8>.

Response

202

Kameleoon processed the URL query and accepted the request. The response returns no content.
Kameleoon processes the body asynchronously and has not checked the body syntax yet.