Listing the addresses of fixed locations for loading and unloading

Get­ting of per­ma­nent unload­ing and load­ing list loca­tions. Users of ship­per accounts can use the list of ten places they often use. Saved loca­tions can be changed and used for load­ing or unload­ing.

Url parameters and connection settings

• URL: https://api.platform.trans.eu
• End­point: /ex­t/­sug­ges­tions-api/v1/­sug­ges­tion­s/spots
• Method: GET

Headers:

• Con­tent-type: application/json
• Accept: application/json
• Autho­riza­tion: Bear­er {access_token}
• Api-key: {unique_app_api_key}

Authorization

Autho­riza­tion process is described here. Each API request must also con­sist of unique Api-key obtained dur­ing appli­ca­tion reg­is­tra­tion togeth­er with client_id and client_secret.

Response

Sam­ple of response for get­ting list of saved loca­tion.

{
  "has_next_page": true,
  "page": 1,
  "page_size": 5,
  "suggestions": [
    {
      "account_id": 12345678,
      "company_id": 7654321,
      "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"
    },
    {
      "next_suggestion": "next_suggestion"
    }
  ]
}

Paging

When call­ing GET method, page should be added as para­me­ter in the URL, for exam­ple: https://api.platform.trans.eu/ext/suggestions-api/v1/suggestions/spots?page=4