Adding the addresses of fixed locations for loading and unloading

Adding places to your frequently used list. Users of shipper accounts can use the list of ten places they often use. Saved locations can be changed and used for loading or unloading.

Url parameters and connection settings

URL: https://api.platform.trans.eu
Endpoint: /ext/suggestions-api/v1/suggestions/spots
Method: POST

Headers:

Content-type: application/json
Accept: application/json
Authorization: Bearer {access_token}
Api-key: {unique_app_api_key}

Authorization

Authorization process is described here. Each API request must also consist of unique Api-key obtained during application registration together with client_id and client_secret.

Structure of posting new suggestions

Json	Example	Type	Is required	Description
name	“test1”	string	No	Locality name
street	“Kopernika”	string	Yes	Stree
number	“9a”	string	Yes	number of street
locality	“Jordanów Śląski”	string	Yes	Locality (e.g. city name)
postal_code	“55-065”	string	Yes	postal_code
country	“PL”	string	Yes	Code of country
details	“Additional information”	string	No	Additional information

Request body

Sample of request for getting list of saved location.

{
   "name": "test",
   "street": "Kopernika",
   "number": "9",
   "locality": "Jordanów Śląski",
   "postal_code": "55-065",
   "country": "PL",
   "details": "test test"
}

Responses

Code: 200 – Success

[
{
   "account_id": 10116324,
   "company_id": 1038173,
   "counter": 45,
   "data": 
{
   "country": "NL",
   "latitude": 52.37403,
   "locality": "Amsterdam",
   "longitude": 4.8936041,
   "name": "Nazwa firmy, lokalizacja 1",
   "number": "12",
   "postalCode": "1012",
   "street": "Ulica",
   "details": "some details"
},
"id": "af44e8d9-9604-48b0-af40-21663431663f"
}
]

Code: 422 – Invalid payload