Fix exception in the example proxy when specifying a language for the international API methods

Author: JozefVerhoef

example/README.md

@@ -18,17 +18,17 @@ any supported method, for example:
 `example/index.php?p=dutchAddressByPostcode/2012es/31`
 
 ### Show autocomplete results for a German lookup
-`example/index.php?p=internationalAutocomplete/deu/strass`
+`example/index.php?p=internationalAutocomplete/deu/berlin`
 
 ### Show details for a German autocomplete lookup
-`example/index.php?p=internationalGetDetails/deu6SVBbpsiLAfbIGnJSvrXjowbUfFAEQxTRQHTsHM9gj76DzsZ6P3BBv8bOknW7MXrI8OJuDanqDp7iy8WwE7woYhDTqHIpSilNHbOTx00CL8QmigIZ1yxr9PNVyRIL9cPQPhwfDpYYo0NgSeI9E`
+`example/index.php?p=internationalGetDetails/deu8jKJe6loItZqtGADAIQGhsPCv9lzLDkd8gfldjgkL4auvVBghq9FoiAuO51y2cL1WohglY2INCswqCGlak7NOm30ELGKca7R8pamRPzapHYQRDVC75lB7eDs26l38FuHTw6Ijp2ISEfN8l2thu1kUa`
 
 Please only use this proxy as an example for your own implementation.
 What you should add:
 
-* Don't allow random calls but implement what you use in a custom wrapper
-* Add caching to prevent fetching the same data over and over
-* Add Session by reading `$_COOKIE`, don't pass it in the URL
+* Don't allow random calls but implement what you use in a custom wrapper.
+* Add caching to prevent fetching the same data over and over.
+* Properly implement session identifiers when using the international autocomplete API. Use a new identifier for each address being validated.
 * Configure your webserver to send all requests under a certain directory to your proxy
  so you don't need to use `?p=`
 

example/autocomplete.html

@@ -19,6 +19,7 @@
 		const inputElement = document.querySelector('.input-autocomplete'),
 			autocomplete = new PostcodeNl.AutocompleteAddress(inputElement, {
 				context: 'nld',
+				language: 'en-GB',
 				autocompleteUrl: 'index.php?p=internationalAutocomplete', // Required
 				addressDetailsUrl: 'index.php?p=internationalGetDetails', // Required
 			});

example/index.php

@@ -28,11 +28,28 @@
 	if (0 !== strpos($action, 'international') && 0 !== strpos($action, 'dutchAddress'))
 		throw new Exception('This example only supports calls to international or dutchAddress methods');
 
-	if ($action == 'internationalAutocomplete' || $action == 'internationalGetDetails')
-		$parts []= 'MY_SESSION_ID';
+	// Use the session header if it was specified already (the Postcode.nl js library will generate one automatically, for example)
+	// Fall back to a place holder identifier. Don't use a fixed identifier for production environments, please read:
+	// https://api.postcode.nl/documentation/international/v1/Autocomplete/autocomplete
+	$sessionHeaderKey = 'HTTP_' . str_replace('-', '_', strtoupper(PostcodeNl\Api\Client::SESSION_HEADER_KEY));
+	$sessionId = $_SERVER[$sessionHeaderKey] ?? 'MY_SESSION_ID';
 
 	$client = new PostcodeNl\Api\Client(API_KEY, API_SECRET, PLATFORM);
-	print json_encode(call_user_func_array([$client, $action], $parts));
+
+	switch ($action)
+	{
+		case 'internationalAutocomplete':
+			$response = $client->internationalAutocomplete($parts[0], $parts[1], $sessionId, $parts[2] ?? null);
+			break;
+		case 'internationalGetDetails':
+			$response = $client->internationalGetDetails($parts[0], $sessionId);
+			break;
+		default:
+			$response = call_user_func_array([$client, $action], $parts);
+			break;
+	}
+
+	print json_encode($response);
 }
 catch (Exception $e)
 {