get {locations_endpoint_url}/{location_id}[/{evse_uid}][/{connector_id}]

openapi/components/parameters/connectorId.yaml

@@ -0,0 +1,7 @@
+name: connector_id
+in: path
+required: true
+schema:
+  type: string
+  maxLength: 36
+  example: 1

openapi/components/parameters/evseUid.yaml

@@ -0,0 +1,7 @@
+name: evse_uid
+in: path
+required: true
+schema:
+  type: string
+  maxLength: 36
+  example: 3256

openapi/components/parameters/locationId.yaml

@@ -0,0 +1,7 @@
+name: location_id
+in: path
+required: true
+schema:
+  type: string
+  maxLength: 36
+  example: LOC1

openapi/components/responses/BaseResponse.yaml

@@ -3,11 +3,15 @@ required:
   - timestamp
 properties:
   data:
-    description: Contains the actual response data object or list of objects from each request, depending on the cardinality of the response data, this is an array (card. * or +), or a single object (card. 1 or ?)
+    description: |
+      * or ?
+      Contains the actual response data object or list of objects from each request, depending on the cardinality of the response data, this is an array (card. * or +), or a single object (card. 1 or ?)
   status_code:
     type: number
+    example: 200
   status_message:
     type: string
+    example: OK
   timestamp:
     type: string
     format: date-time

openapi/components/responses/Location.yaml

@@ -0,0 +1,9 @@
+description: Location
+content:
+  application/json:
+    schema:
+      allOf:
+        - $ref: ./BaseResponse.yaml
+        - properties:
+            data:
+              $ref: ../schemas/Location.yaml

openapi/openapi.yaml

@@ -65,6 +65,12 @@ paths:
     $ref: paths/credentials.yaml
   /locations:
     $ref: paths/locations.yaml
+  /locations/{location_id}:
+    $ref: paths/locations_{location_id}.yaml
+  /locations/{location_id}/{evse_uid}:
+    $ref: paths/locations_{location_id}_{evse_uid}.yaml
+  /locations/{location_id}/{evse_uid}/{connector_id}:
+    $ref: paths/locations_{location_id}_{evse_uid}_{connector_id}.yaml
 
 components:
   securitySchemes:

openapi/paths/locations_{location_id}.yaml

@@ -0,0 +1,16 @@
+get:
+  tags:
+    - Locations
+  summary: Sender /locations/{location_id}
+  operationId: getLocation_by_location_id
+  security:
+    - tokenAuth: []
+  parameters:
+    - $ref: ../components/parameters/locationId.yaml
+  responses:
+    "200":
+      $ref: ../components/responses/Location.yaml
+    "400":
+      $ref: ../components/responses/BadRequest.yaml
+    "404":
+      $ref: ../components/responses/NotFound.yaml

openapi/paths/locations_{location_id}_{evse_uid}.yaml

@@ -0,0 +1,17 @@
+get:
+  tags:
+    - Locations
+  summary: Sender /locations/{location_id}/{evse_uid}
+  operationId: getLocation_by_location_id_evse_uid
+  security:
+    - tokenAuth: []
+  parameters:
+    - $ref: ../components/parameters/locationId.yaml
+    - $ref: ../components/parameters/evseUid.yaml
+  responses:
+    "200":
+      $ref: ../components/responses/Location.yaml
+    "400":
+      $ref: ../components/responses/BadRequest.yaml
+    "404":
+      $ref: ../components/responses/NotFound.yaml

openapi/paths/locations_{location_id}_{evse_uid}_{connector_id}.yaml

@@ -0,0 +1,18 @@
+get:
+  tags:
+    - Locations
+  summary: Sender /locations/{location_id}/{evse_uid}]/[{connector_id}
+  operationId: getLocation_by_location_id_evse_uid_connector_id
+  security:
+    - tokenAuth: []
+  parameters:
+    - $ref: ../components/parameters/locationId.yaml
+    - $ref: ../components/parameters/evseUid.yaml
+    - $ref: ../components/parameters/connectorId.yaml
+  responses:
+    "200":
+      $ref: ../components/responses/Location.yaml
+    "400":
+      $ref: ../components/responses/BadRequest.yaml
+    "404":
+      $ref: ../components/responses/NotFound.yaml