Release note - v0.3405.0

Highlights

• New GET/v0/salesman/{salesman_id} route to retrieve salesman information
• Authentication restricted to G.O users only
• Support for multiple locales for countries like Switzerland
• Return of salesman information including sales network, agency, and partner

v0.3405.0 Details

This version introduces a new resource to retrieve detailed information about a salesman using their ID.

New Salesman Route

The GET/v0/salesman/{salesman_id} route allows you to retrieve complete information about a salesman, including:

• Personal information (first name, last name, email)
• Identifiers (salesman_id, partner_id, sales_network_id)
• Associated agency (full name)
• List of authorized locales for this salesman

This route requires G.O authentication and expects the salesman ID as a path parameter, as well as an API key in the request header.

Locale Management

The response includes an array of locales in ISO 639-1 (language) and ISO 3166-1 (country) format. The mapping takes into account countries with multiple locales, such as Switzerland, by returning all locales corresponding to the salesman's commercial country code.

Response Example

{
  "first_name": "John",
  "last_name": "Smith",
  "email": "johnsmith@gmail.com",
  "salesman_id": "123456789",
  "sales_network_id": "OPERA_00_P2T",
  "agency_full_name": "OPERA Agency",
  "partner_id": "CME12345",
  "locales": ["fr-FR"]
}

All returned fields are mandatory and guarantee the completeness of the salesman's information.