Authentication & Parameters

Authentication

The Relay Point Map uses a channel-based authentication system. You must include your unique channel identifier in the channelId URL parameter for every request.

URL Parameters

Required Parameters

Parameter	Type	Description	Example
channelId	string	Your unique channel identifier (required)	YOUR_CHANNEL_ID

Optional Parameters

Parameter	Type	Description	Example
service	string	Carrier service code	MONDIAL_RELAY
line1	string	Street address	123 rue de Rivoli
zip	string	Postal code	75001
city	string	City name	Paris
countryCode	string	ISO 3166-1 alpha-2 country code	FR
callbackUrl	string	Webhook URL for relay point selection	https://yourapplication.com/webhook/relay-point

Building URLs Programmatically

URL Parameter Examples

Examples showing how to build relay point map URLs in different programming languages

const buildRelayMapUrl = (channelId, params) => {
const baseUrl = 'https://relay-points-map.wing.eu';
const queryParams = new URLSearchParams({
  channelId,
  ...params
});
return `${baseUrl}?${queryParams.toString()}`;
};

// Basic URL with your channel ID
const basicUrl = buildRelayMapUrl('YOUR_CHANNEL_ID', {});

// With address pre-fill
const withAddress = buildRelayMapUrl('YOUR_CHANNEL_ID', {
service: 'MONDIAL_RELAY',
line1: '123 rue de Rivoli',
zip: '75001',
city: 'Paris',
countryCode: 'FR'
});

// With callback
const withCallback = buildRelayMapUrl('YOUR_CHANNEL_ID', {
service: 'MONDIAL_RELAY',
callbackUrl: 'https://yourapplication.com/webhook/relay-point'
});