S2S ping - Revision history

Admin at 14:20, 19 December 2025

2025-12-19T14:20:29Z

← Older revision		Revision as of 14:20, 19 December 2025
Line 69:		Line 69:
	\| x-forwarded-for \|\| IP \|\| yes		\| x-forwarded-for \|\| IP \|\| yes
	\|-		\|-
	~~\| x-real-ip \|\| IP \|\| no~~		\| x-requested-with \|\| Application name \|\| no
	\|-
	\| x-requested-with \|\| IP \|\| no
	\|-		\|-
	\| sec-ch-ua-arch \|\| \|\| no		\| sec-ch-ua-arch \|\| \|\| no

Admin at 14:15, 19 December 2025

2025-12-19T14:15:10Z

← Older revision		Revision as of 14:15, 19 December 2025
Line 70:		Line 70:
	\|-		\|-
	\| x-real-ip \|\| IP \|\| no		\| x-real-ip \|\| IP \|\| no
			\|-
			\| x-requested-with \|\| IP \|\| no
	\|-		\|-
	\| sec-ch-ua-arch \|\| \|\| no		\| sec-ch-ua-arch \|\| \|\| no
Line 146:		Line 148:
	'X-Original-Ip:' . $_SERVER['REMOTE_ADDR'],		'X-Original-Ip:' . $_SERVER['REMOTE_ADDR'],
	isset($_SERVER['X_FORWARDED_FOR']) ? 'X-Forwarded-For:' . $_SERVER['X_FORWARDED_FOR'] : '',		isset($_SERVER['X_FORWARDED_FOR']) ? 'X-Forwarded-For:' . $_SERVER['X_FORWARDED_FOR'] : '',
			isset($_SERVER['X_REQUESTED_WITH']) ? 'X-Requested-With:' . $_SERVER['X_REQUESTED_WITH'] : '',
	isset($_SERVER['HTTP_SEC_CH_UA_ARCH']) ? 'Sec-CH-UA-Arch:' . $_SERVER['HTTP_SEC_CH_UA_ARCH'] : '',		isset($_SERVER['HTTP_SEC_CH_UA_ARCH']) ? 'Sec-CH-UA-Arch:' . $_SERVER['HTTP_SEC_CH_UA_ARCH'] : '',
	isset($_SERVER['HTTP_SEC_CH_UA']) ? 'Sec-CH-UA:' . $_SERVER['HTTP_SEC_CH_UA'] : '',		isset($_SERVER['HTTP_SEC_CH_UA']) ? 'Sec-CH-UA:' . $_SERVER['HTTP_SEC_CH_UA'] : '',

Admin at 16:53, 11 October 2024

2024-10-11T16:53:04Z

← Older revision		Revision as of 16:53, 11 October 2024
Line 40:		Line 40:
	\| sub1 \|\| Filled sub-tags. If you do not use certain tags, there is no need to send them. \|\| no		\| sub1 \|\| Filled sub-tags. If you do not use certain tags, there is no need to send them. \|\| no
	\|-		\|-
	\| sub2 \|\| ... \|\| ~~нет~~		\| sub2 \|\| ... \|\| no
	\|-		\|-
	\| sub3 \|\| ... \|\| ~~нет~~		\| sub3 \|\| ... \|\| no
	\|-		\|-
	\| sub4 \|\| ... \|\| ~~нет~~		\| sub4 \|\| ... \|\| no
	\|-		\|-
	\| sub5 \|\| ... \|\| ~~нет~~		\| sub5 \|\| ... \|\| no
	\|-		\|-
	\| sub6 \|\| ... \|\| ~~нет~~		\| sub6 \|\| ... \|\| no
	\|-		\|-
	\| sub7 \|\| ... \|\| ~~нет~~		\| sub7 \|\| ... \|\| no
	\|}		\|}

Line 57:		Line 57:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! Parameter Name !! Parameter Description		! Parameter Name !! Parameter Description !! Mandatory?
	\|-		\|-
	\| user-agent \|\| User agent		\| user-agent \|\| User agent \|\| yes
	\|-		\|-
	\| referer \|\| Page the user came from		\| referer \|\| Page the user came from \|\| no
	\|-		\|-
	\| accept-language \|\| Browser interface language		\| accept-language \|\| Browser interface language \|\| yes
	\|-		\|-
	\| x-original-ip \|\| Real user IP		\| x-original-ip \|\| Real user IP \|\| yes
	\|-		\|-
	\| x-forwarded-for \|\| IP		\| x-forwarded-for \|\| IP \|\| yes
	\|-		\|-
	\| x-real-ip \|\| IP		\| x-real-ip \|\| IP \|\| no
	\|-		\|-
	\| sec-ch-ua-arch \|\|		\| sec-ch-ua-arch \|\| \|\| no
	\|-		\|-
	\| sec-ch-ua \|\|		\| sec-ch-ua \|\| \|\| no
	\|-		\|-
	\| sec-ch-ua-full-version \|\|		\| sec-ch-ua-full-version \|\| \|\| no
	\|-		\|-
	\| device-memory \|\|		\| device-memory \|\| \|\| no
	\|-		\|-
	\| dpr \|\|		\| dpr \|\| \|\| no
	\|-		\|-
	\| sec-ch-ua-mobile \|\|		\| sec-ch-ua-mobile \|\| \|\| no
	\|-		\|-
	\| sec-ch-ua-model \|\|		\| sec-ch-ua-model \|\| \|\| no
	\|-		\|-
	\| sec-ch-ua-platform \|\|		\| sec-ch-ua-platform \|\| \|\| no
	\|-		\|-
	\| sec-ch-ua-platform-version \|\|		\| sec-ch-ua-platform-version \|\| \|\| no
	\|-		\|-
	\| viewport-width \|\|		\| viewport-width \|\| \|\| no
	\|}		\|}

Line 96:		Line 96:
	<pre>		<pre>
	curl 'https://kaminari.systems/v2/ping' \		curl 'https://kaminari.systems/v2/ping' \
	-H 'accept: application/json' \		-H 'accept: application/json' \
	-H 'accept-language: en-US,en;q=0.9' \		-H 'accept-language: en-US,en;q=0.9,uk;q=0.8' \
	-H 'cache-control: no-cache' \		-H 'cache-control: no-cache' \
	-H 'content-type: ~~text~~/~~plain~~;charset=UTF-8' \		-H 'content-type: application/json;charset=UTF-8' \
	-H 'origin: https://test.com' \		-H 'origin: https://test.com' \
	-H 'pragma: no-cache' \		-H 'pragma: no-cache' \
	-H 'referer: https://test.com/' \		-H 'referer: https://test.com/' \
	-H 'user-agent: Mozilla/5.0 (~~Windows NT 6.3~~; ~~Win64; x64~~) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/~~105~~.0.0.0 Safari/537.36'		-H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/129.0.0.0 Safari/537.36' \
			-H 'x-original-ip: 127.0.0.1' \
			-H 'x-forwarded-for: 192.168.0.1' \
			-H 'sec-ch-ua-arch: "x86"' \
			-H 'sec-ch-ua: "Google Chrome";v="129", "Not=A?Brand";v="8", "Chromium";v="129"' \
			-H 'sec-ch-ua-full-version: "129.0.6668.100"' \
			-H 'device-memory: 8' \
			-H 'dpr: 2' \
			-H 'sec-ch-ua-mobile: ?0' \
			-H 'sec-ch-ua-model: ""' \
			-H 'sec-ch-ua-platform: "macOS"' \
			-H 'sec-ch-ua-platform-version: "14.5.0"' \
			-H 'viewport-width: 981' \
	--data-raw '{"kmnrKey":"XXXXXXXX","kmnrId":"1125570260","sub1":"test","sub2":"1001","sub3":"10","sub4":"1385282124113622","sub5":"222","sub6":"555666","sub7":"8833705265931305"}'		--data-raw '{"kmnrKey":"XXXXXXXX","kmnrId":"1125570260","sub1":"test","sub2":"1001","sub3":"10","sub4":"1385282124113622","sub5":"222","sub6":"555666","sub7":"8833705265931305"}'
	--compressed		--compressed
Line 128:		Line 140:
	curl_setopt( $ch, CURLOPT_POSTFIELDS, $payload );		curl_setopt( $ch, CURLOPT_POSTFIELDS, $payload );
	curl_setopt( $ch, CURLOPT_HTTPHEADER, [		curl_setopt( $ch, CURLOPT_HTTPHEADER, [
	'Content-Type:application/json',		'Content-Type:application/json;charset=UTF-8',
	'Accept-Language:' . $_SERVER['HTTP_ACCEPT_LANGUAGE'],		'Accept-Language:' . $_SERVER['HTTP_ACCEPT_LANGUAGE'],
	'User-Agent:' . $_SERVER['HTTP_USER_AGENT'],		'User-Agent:' . $_SERVER['HTTP_USER_AGENT'],
	isset($_SERVER['HTTP_REFERER']) ? 'Referer:' . $_SERVER['HTTP_REFERER'] : '',		isset($_SERVER['HTTP_REFERER']) ? 'Referer:' . $_SERVER['HTTP_REFERER'] : '',
			'X-Original-Ip:' . $_SERVER['REMOTE_ADDR'],
			isset($_SERVER['X_FORWARDED_FOR']) ? 'X-Forwarded-For:' . $_SERVER['X_FORWARDED_FOR'] : '',
			isset($_SERVER['HTTP_SEC_CH_UA_ARCH']) ? 'Sec-CH-UA-Arch:' . $_SERVER['HTTP_SEC_CH_UA_ARCH'] : '',
			isset($_SERVER['HTTP_SEC_CH_UA']) ? 'Sec-CH-UA:' . $_SERVER['HTTP_SEC_CH_UA'] : '',
			isset($_SERVER['HTTP_SEC_CH_UA_FULL_VERSION']) ? 'Sec-CH-UA-Full-Version:' . $_SERVER['HTTP_SEC_CH_UA_FULL_VERSION'] : '',
			isset($_SERVER['HTTP_DEVICE_MEMORY']) ? 'Device-Memory:' . $_SERVER['HTTP_DEVICE_MEMORY'] : '',
			isset($_SERVER['HTTP_DPR']) ? 'DPR:' . $_SERVER['HTTP_DPR'] : '',
			isset($_SERVER['HTTP_SEC_CH_UA_MOBILE']) ? 'Sec-CH-UA-Mobile:' . $_SERVER['HTTP_SEC_CH_UA_MOBILE'] : '',
			isset($_SERVER['HTTP_SEC_CH_UA_MODEL']) ? 'Sec-CH-UA-Model:' . $_SERVER['HTTP_SEC_CH_UA_MODEL'] : '',
			isset($_SERVER['HTTP_SEC_CH_UA_PLATFORM']) ? 'Sec-CH-UA-Platform:' . $_SERVER['HTTP_SEC_CH_UA_PLATFORM'] : '',
			isset($_SERVER['HTTP_SEC_CH_UA_PLATFORM_VERSION']) ? 'Sec-CH-UA-Platform-Version:' . $_SERVER['HTTP_SEC_CH_UA_PLATFORM_VERSION'] : '',
			isset($_SERVER['HTTP_VIEWPORT_WIDTH']) ? 'Viewport-Width:' . $_SERVER['HTTP_VIEWPORT_WIDTH'] : '',
	]);		]);
	curl_exec($ch);		curl_exec($ch);

Admin: Marked this version for translation

2023-09-19T02:11:46Z

Marked this version for translation

← Older revision		Revision as of 02:11, 19 September 2023
Line 1:		Line 1:
	<languages/>		<languages/>
	<translate>		<translate>
			<!--T:1-->
	= General workflow =		= General workflow =
	# The user arrives at your website. You generate a unique <code>kmnrId</code> and send it to Kaminari server via /ping URL, and we save the data in the cache.		# The user arrives at your website. You generate a unique <code>kmnrId</code> and send it to Kaminari server via /ping URL, and we save the data in the cache.
Line 10:		Line 11:
	## We also periodically check the cache and look for expired clicks that came to /ping but remained unpaired. If we couldn't verify them in any way, we write them to statistics with the status "Technical Losses."		## We also periodically check the cache and look for expired clicks that came to /ping but remained unpaired. If we couldn't verify them in any way, we write them to statistics with the status "Technical Losses."

	= Client-side configuration =		= Client-side configuration = <!--T:2-->

			<!--T:3-->
	== Sending data to https://kaminari.systems/v2/ping ==		== Sending data to https://kaminari.systems/v2/ping ==
	When a user visits the page, it is necessary to generate a unique display <code>kmnrId</code> on the client-side backend.		When a user visits the page, it is necessary to generate a unique display <code>kmnrId</code> on the client-side backend.

			<!--T:4-->
	Then, using PHP, Python, NodeJS, depending on the technology your website is built on, send initializing information to the https://kaminari.systems/v2/ping in the background.		Then, using PHP, Python, NodeJS, depending on the technology your website is built on, send initializing information to the https://kaminari.systems/v2/ping in the background.

			<!--T:5-->
	The request may not be accepted on the first attempt (in which case, the server will respond with a 204 status), so we recommend sending the request in a loop until you receive a response with a 200 status.		The request may not be accepted on the first attempt (in which case, the server will respond with a 204 status), so we recommend sending the request in a loop until you receive a response with a 200 status.

			<!--T:6-->
	The data should be sent using the POST method in JSON format.		The data should be sent using the POST method in JSON format.

			<!--T:7-->
	List of parameters:		List of parameters:

			<!--T:8-->
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
Line 46:		Line 53:
	\|}		\|}

			<!--T:9-->
	In addition, the following headers obtained from the user should be added to this request:		In addition, the following headers obtained from the user should be added to this request:
	{\| class="wikitable"		{\| class="wikitable"
Line 84:		Line 92:
	\|}		\|}

			<!--T:10-->
	Example in CURL:		Example in CURL:
	<pre>		<pre>
Line 99:		Line 108:
	</pre>		</pre>

			<!--T:11-->
	Example in PHP:		Example in PHP:
	<pre>		<pre>
Line 115:		Line 125:
	]);		]);

			<!--T:12-->
	curl_setopt( $ch, CURLOPT_POSTFIELDS, $payload );		curl_setopt( $ch, CURLOPT_POSTFIELDS, $payload );
	curl_setopt( $ch, CURLOPT_HTTPHEADER, [		curl_setopt( $ch, CURLOPT_HTTPHEADER, [
Line 126:		Line 137:
	</pre>		</pre>

			<!--T:13-->
	== Adding kmnrId to the script ==		== Adding kmnrId to the script ==
	The generated <code>kmnrId</code>, as well as the <code>kmnrKey</code> and sub-tags, should then be passed into the call of the JavaScript script on the page.		The generated <code>kmnrId</code>, as well as the <code>kmnrKey</code> and sub-tags, should then be passed into the call of the JavaScript script on the page.

			<!--T:14-->
	<pre>		<pre>
	<script>		<script>
Line 143:		Line 156:
	};		};

	var kmnrSc = document.createElement('script');		<!--T:15-->
			var kmnrSc = document.createElement('script');
	var kmnrPrnt = document.getElementsByTagName('head')[0] \|\| document.body;		var kmnrPrnt = document.getElementsByTagName('head')[0] \|\| document.body;
	kmnrSc.setAttribute('async', true);		kmnrSc.setAttribute('async', true);
Line 152:		Line 166:
	</pre>		</pre>

	= Testing =		= Testing = <!--T:16-->

			<!--T:17-->
	For testing data transmission and ensuring their compatibility with the API, you can use the following URL: https://kaminari.systems/v1/pingtest		For testing data transmission and ensuring their compatibility with the API, you can use the following URL: https://kaminari.systems/v1/pingtest

			<!--T:18-->
	=== Example in PHP: ===		=== Example in PHP: ===
	<pre>		<pre>
Line 173:		Line 189:
	]);		]);

	curl_setopt( $ch, CURLOPT_POSTFIELDS, $payload );		<!--T:19-->
			curl_setopt( $ch, CURLOPT_POSTFIELDS, $payload );
	curl_setopt( $ch, CURLOPT_HTTPHEADER, [		curl_setopt( $ch, CURLOPT_HTTPHEADER, [
	'Content-Type:application/json',		'Content-Type:application/json',
Line 193:		Line 210:
	echo "<pre>2. Response body: $body</pre>";		echo "<pre>2. Response body: $body</pre>";

	'curl error: ' . curl_error($ch);		<!--T:20-->
			'curl error: ' . curl_error($ch);
	curl_close($ch);		curl_close($ch);
	} catch (Exception $e) {		} catch (Exception $e) {
Line 200:		Line 218:
	</pre>		</pre>

			<!--T:21-->
	Response :		Response :
	<pre>		<pre>
Line 217:		Line 236:
	</pre>		</pre>

			<!--T:22-->
	=== Example in Node.js: ===		=== Example in Node.js: ===
	<pre>		<pre>
	const https = require('https');		const https = require('https');

			<!--T:23-->
	const payload = JSON.stringify({		const payload = JSON.stringify({
	'kmnrKey': 'XXXXXXXX',		'kmnrKey': 'XXXXXXXX',
Line 233:		Line 254:
	});		});

			<!--T:24-->
	const options = {		const options = {
	host: 'kaminari.click',		host: 'kaminari.click',
Line 248:		Line 270:
	};		};

			<!--T:25-->
	const req = https		const req = https
	.request(options, (res) => {		.request(options, (res) => {
	let data = '';		let data = '';

	res.on('data', (chunk) => {		<!--T:26-->
			res.on('data', (chunk) => {
	data += chunk;		data += chunk;
	});		});
Line 266:		Line 290:
	});		});

			<!--T:27-->
	req.on('error', (err) => {		req.on('error', (err) => {
	console.log("Error: " + err.message);		console.log("Error: " + err.message);
Line 273:		Line 298:
	</pre>		</pre>

			<!--T:28-->
	Response:		Response:
	<pre>		<pre>

Admin at 02:11, 19 September 2023

2023-09-19T02:11:35Z

Show changes

Admin at 16:14, 6 September 2023

2023-09-06T16:14:41Z

← Older revision		Revision as of 16:14, 6 September 2023
Line 1:		Line 1:
			[[S2S ping en\|English version]]

	= Общий алгоритм работы =		= Общий алгоритм работы =
	# Пользователь приходит на ваш сайт. Вы генерируете уникальный <code>kmnrId</code> и отстукиваетесь с ним на сервер Kaminari на URL /ping, мы сохраняем данные в кэш.		# Пользователь приходит на ваш сайт. Вы генерируете уникальный <code>kmnrId</code> и отстукиваетесь с ним на сервер Kaminari на URL /ping, мы сохраняем данные в кэш.

Admin: /* Отправка данных на https://kaminari.systems/v2/ping */

2023-06-15T13:48:35Z

Отправка данных на https://kaminari.systems/v2/ping

← Older revision		Revision as of 13:48, 15 June 2023
Line 15:		Line 15:
	Затем с помощью PHP, Python, NodeJS — в зависимости от того, на чём у вас написан сайт — послать на URL https://kaminari.systems/v2/ping инициализирующую информацию.		Затем с помощью PHP, Python, NodeJS — в зависимости от того, на чём у вас написан сайт — послать на URL https://kaminari.systems/v2/ping инициализирующую информацию.

	Запрос может не быть принят с первого раз (в таком случае сервер пришлёт статус 204), мы советуем слать запрос в цикле до получения ответа ~~равного~~ 200.		Запрос может не быть принят с первого раз (в таком случае сервер пришлёт статус 204), мы советуем слать запрос в цикле до получения ответа со статусом 200.

	Данные должны слаться методом POST в формате JSON.		Данные должны слаться методом POST в формате JSON.

Admin: /* Отправка данных на https://kaminari.systems/v2/ping */

2023-06-15T13:48:06Z

Отправка данных на https://kaminari.systems/v2/ping

← Older revision		Revision as of 13:48, 15 June 2023
Line 14:		Line 14:

	Затем с помощью PHP, Python, NodeJS — в зависимости от того, на чём у вас написан сайт — послать на URL https://kaminari.systems/v2/ping инициализирующую информацию.		Затем с помощью PHP, Python, NodeJS — в зависимости от того, на чём у вас написан сайт — послать на URL https://kaminari.systems/v2/ping инициализирующую информацию.

			Запрос может не быть принят с первого раз (в таком случае сервер пришлёт статус 204), мы советуем слать запрос в цикле до получения ответа равного 200.

	Данные должны слаться методом POST в формате JSON.		Данные должны слаться методом POST в формате JSON.

Admin at 22:33, 9 June 2023

2023-06-09T22:33:17Z

← Older revision		Revision as of 22:33, 9 June 2023
Line 174:		Line 174:
	'Accept-Language:' . $_SERVER['HTTP_ACCEPT_LANGUAGE'],		'Accept-Language:' . $_SERVER['HTTP_ACCEPT_LANGUAGE'],
	'User-Agent:' . $_SERVER['HTTP_USER_AGENT'],		'User-Agent:' . $_SERVER['HTTP_USER_AGENT'],
	'DPR:~~200~~',		'DPR:2',
	isset($_SERVER['HTTP_REFERER']) ? 'Referer:' . $_SERVER['HTTP_REFERER'] : 'Referer:""',		isset($_SERVER['HTTP_REFERER']) ? 'Referer:' . $_SERVER['HTTP_REFERER'] : 'Referer:""',
	]);		]);
Line 239:		Line 239:
	'Accept-Language': 'en-US,en;q=0.5',		'Accept-Language': 'en-US,en;q=0.5',
	'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/113.0',		'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/113.0',
	'DPR': '~~200~~',		'DPR': '2',
	'Referer': '""',		'Referer': '""',
	}		}

Admin: /* Пример на Node.js: */

2023-06-09T14:07:57Z

Пример на Node.js:

← Older revision		Revision as of 14:07, 9 June 2023
Line 238:		Line 238:
	'Content-Length': Buffer.byteLength(payload),		'Content-Length': Buffer.byteLength(payload),
	'Accept-Language': 'en-US,en;q=0.5',		'Accept-Language': 'en-US,en;q=0.5',
	'User-Agent': 'Mozilla/5.0 (~~Linux~~; ~~Android 10~~; K) ~~AppleWebKit~~/~~537.36 (KHTML, like Gecko) Chrome~~/~~114.0.0~~.0 ~~Mobile Safari/537.36~~',		'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:109.0) Gecko/20100101 Firefox/113.0',
	'DPR': '200',		'DPR': '200',
	'Referer': '""',		'Referer': '""',