Editorials in the description and updated split files 64/64/1 master
authorfeatherstone <walter.featherstone@viavisolutions.com>
Thu, 13 Jul 2017 10:22:14 +0000 (11:22 +0100)
committerfeatherstone <walter.featherstone@viavisolutions.com>
Thu, 13 Jul 2017 10:22:14 +0000 (11:22 +0100)
Change-Id: Ie4fbdb6cfa1ffe977f0ddfb317e55b6c9dc2bb83
Signed-off-by: featherstone <walter.featherstone@viavisolutions.com>
53 files changed:
LocationAPI.index.yaml [deleted file]
definitions/AccessPointId.yaml
definitions/AccessPointInfo.yaml
definitions/AccessPointList.yaml
definitions/AncillaryInfo.yaml
definitions/CallbackReference.yaml
definitions/ContextLocationInfo.yaml
definitions/Link.yaml
definitions/UserInfo.yaml
definitions/UserList.yaml
definitions/UserTrackingSubscription.yaml
definitions/ZonalPresenceNotification.yaml
definitions/ZonalTrafficSubscription.yaml
definitions/ZoneInfo.yaml
definitions/ZoneList.yaml
definitions/ZoneStatusNotification.yaml
definitions/ZoneStatusSubscription.yaml
definitions/index.yaml
externalDocs/index.yaml
info/index.yaml
parameters/AccessPointId.yaml [deleted file]
parameters/Body.UserTrackingSubscription.yaml [new file with mode: 0644]
parameters/Body.ZonalTrafficSubscription.yaml [new file with mode: 0644]
parameters/Body.ZoneStatusSubscription.yaml [new file with mode: 0644]
parameters/InterestRealm.yaml [deleted file]
parameters/Path.AccessPointId.yaml [new file with mode: 0644]
parameters/Path.SubscriptionId.yaml [new file with mode: 0644]
parameters/Path.UserId.yaml [new file with mode: 0644]
parameters/Path.ZoneId.yaml [new file with mode: 0644]
parameters/Query.AccessPointId.yaml [new file with mode: 0644]
parameters/Query.InterestRealm.yaml [new file with mode: 0644]
parameters/Query.ZoneId.yaml [new file with mode: 0644]
parameters/ZoneId.yaml [deleted file]
parameters/index.yaml
paths/SubsUserTrackId_Del.yaml
paths/SubsUserTrackId_Get.yaml
paths/SubsUserTrackId_Put.yaml
paths/SubsUserTrack_Post.yaml
paths/SubsZonalTrafId_Del.yaml
paths/SubsZonalTrafId_Get.yaml
paths/SubsZonalTrafId_Put.yaml
paths/SubsZonalTraf_Post.yaml
paths/SubsZoneStatId.yaml
paths/SubsZoneStatId_Del.yaml
paths/SubsZoneStatId_Get.yaml
paths/SubsZoneStatId_Put.yaml
paths/SubsZoneStat_Post.yaml
paths/UsersId_Get.yaml
paths/Users_Get.yaml
paths/ZonesIdApsId_Get.yaml
paths/ZonesIdAps_Get.yaml
paths/ZonesId_Get.yaml
paths/Zones_Get.yaml

diff --git a/LocationAPI.index.yaml b/LocationAPI.index.yaml
deleted file mode 100644 (file)
index 8fc1e88..0000000
+++ /dev/null
@@ -1,52 +0,0 @@
-################################################################################
-#                        Open API specification version                        #
-################################################################################
-swagger: '2.0'
-
-################################################################################
-#                              Document Information                            #
-################################################################################
-info:
-  $ref: './info/index.yaml'
-
-################################################################################
-#                               External Documents                             #
-################################################################################
-externalDocs: 
-  $ref: './externalDocs/index.yaml'
-
-host: 127.0.0.1:8081
-basePath: /exampleAPI/location/v1/
-schemes:
-- http
-- https
-consumes:
-- application/json
-produces:
-- application/json
-
-################################################################################
-#                                   Parameters                                 #
-################################################################################
-parameters:
-  $ref: './parameters/index.yaml'
-
-################################################################################
-#                                   paths                                      #
-################################################################################
-paths:
-  $ref: './paths/index.yaml'
-
-################################################################################
-#                                 Definitions                                  #
-################################################################################
-definitions:
-  $ref: './definitions/index.yaml'
-  
-################################################################################
-# SEEMINGLY NOT ALLOWED in Swagger/OpenAPI 2.0                                 #
-#                                                                              #
-#                                 Examples                                     #
-################################################################################
-#examples:
-#  $ref: './examples/index.yaml'
\ No newline at end of file
index 6c4cf1b..f905377 100644 (file)
@@ -1,4 +1,3 @@
-description: >-
-  Identifier of access point, <E-CGI><Cell Portion ID> (reference ETSI TS 129 171). Where the E-CGI is made up of the PLMN and Cell Identity (28 bit string). Then the PLMN is made up of the 3 digit MCC & 2 or 3 digit MNC. The Cell Portion is an optional element
+description: Identifier of access point, <E-CGI><Cell Portion ID> (reference ETSI TS 129 171). Where the E-CGI is made up of the PLMN and Cell Identity (28 bit string). Then the PLMN is made up of the 3 digit MCC & 2 or 3 digit MNC. The Cell Portion is an optional element
 type: string
 example: "001010000000000000000000000000001"
\ No newline at end of file
index 7dfc453..9a4c4f9 100644 (file)
@@ -1,3 +1,5 @@
+description: A type containing access point information.
+type: object
 required:
 - accessPointId
 - connectionType
index e324425..d864e17 100644 (file)
@@ -1,3 +1,5 @@
+description: A type containing list of access points.
+type: object
 required:
 - zoneId
 - resourceURL
index 90cf1f0..686294c 100644 (file)
@@ -1,5 +1,2 @@
-required:
-- address
-properties:
-  address:
-    $ref: '#/definitions/Address'
\ No newline at end of file
+description: Reserved for future use.
+type: string
\ No newline at end of file
index fb5a1e8..305a899 100644 (file)
@@ -1,3 +1,5 @@
+description: Notification callback definition.
+type: object
 required:
 - notifyURL
 properties:
index 5326e7d..569a725 100644 (file)
@@ -1,3 +1,3 @@
 description: Contextual information of a user location (e.g., aisle, floor, room number, etc.)
 type: string
-example: "GroundFoor"
\ No newline at end of file
+example: "GroundFloor"
\ No newline at end of file
index 163887f..bc8680e 100644 (file)
@@ -1,3 +1,5 @@
+description: Link to other resources
+type: object
 required:
 - rel
 - href
index 5f2bf93..160bca1 100644 (file)
@@ -1,3 +1,5 @@
+description: A type containing user information.
+type: object
 required:
 - address
 - accessPointId
index bfdd096..9de3640 100644 (file)
@@ -1,4 +1,5 @@
 description: A type containing list of users.
+type: object
 required:
 - resourceURL
 properties:
index 4253016..eeabe11 100644 (file)
@@ -1,3 +1,5 @@
+description: A type containing user tracking subscription.
+type: object
 required:
 - callbackReference
 - address
index 3359e3d..2e1bb68 100644 (file)
@@ -1,3 +1,5 @@
+description: A type containing zonal presence notification
+type: object
 required:
 - zoneId
 - address
index 0ab3cfe..d101919 100644 (file)
@@ -16,7 +16,6 @@ properties:
     items:
       $ref: '#/definitions/InterestRealm'
   userEventCriteria:
-#    $ref: '#/definitions/UserEventCriteria'
     description: List of user event values to generate notifications for (these apply to zone identifier or all interest realms within zone identifier specified). If this element is missing, a notification is requested to be generated for any change in user event.
     type: array
     items:
index 8f74b65..4351320 100644 (file)
@@ -1,4 +1,5 @@
 description: A type containing zone information.
+type: object
 required:
 - zoneId
 - numberOfAccessPoints
index e5945c3..63168e7 100644 (file)
@@ -1,4 +1,5 @@
 description: Collection of the zone information list.
+type: object
 required:
 - resourceURL
 properties:
index 5d94491..6c439a6 100644 (file)
@@ -1,3 +1,5 @@
+description: A type containing zone status notification.
+type: object
 required:
 - zoneId
 - timestamp
index 7c9ecb3..3e0790e 100644 (file)
@@ -1,3 +1,5 @@
+description: A type containing zone status subscription.
+type: object
 required:
 - callbackReference
 - zoneId
index 03e08bb..db997a1 100644 (file)
 AccessPointId:
   $ref: ./AccessPointId.yaml
-
 AccessPointInfo:
   $ref: ./AccessPointInfo.yaml
-         
 AccessPointList:
   $ref: ./AccessPointList.yaml
-        
 Address:
   $ref: ./Address.yaml
-
 AncillaryInfo:
   $ref: ./AncillaryInfo.yaml
-
 CallbackData:
   $ref: ./CallbackData.yaml
-
 CallbackReference:
   $ref: ./CallbackReference.yaml
-
 ClientCorrelator:
   $ref: ./ClientCorrelator.yaml
-       
 ConnectionType:
   $ref: ./ConnectionType.yaml
-
 ContextLocationInfo:
   $ref: ./ContextLocationInfo.yaml
-
 CurrentAccessPointId:
   $ref: ./CurrentAccessPointId.yaml
-       
 Duration:
   $ref: ./Duration.yaml
-       
 InterestRealm:
   $ref: ./InterestRealm.yaml
-
 Link:
   $ref: ./Link.yaml
-
 LocationInfo:
   $ref: ./LocationInfo.yaml
-       
 NotifyURL:
   $ref: ./NotifyURL.yaml
-        
 NumberOfAccessPoints:
   $ref: ./NumberOfAccessPoints.yaml
-
 NumberOfUnserviceableAccessPoints:
   $ref: ./NumberOfUnserviceableAccessPoints.yaml
-
 NumberOfUsers:
   $ref: ./NumberOfUsers.yaml
-        
 NumberOfUsersAPThreshold:
   $ref: ./NumberOfUsersAPThreshold.yaml
-
 NumberOfUsersInAP:
   $ref: ./NumberOfUsersInAP.yaml
-        
 NumberOfUsersInZone:
   $ref: ./NumberOfUsersInZone.yaml
-
 NumberOfUsersZoneThreshold:
   $ref: ./NumberOfUsersZoneThreshold.yaml
-
 OperationStatus:
   $ref: ./OperationStatus.yaml
-
 PreviousAccessPointId:
   $ref: ./PreviousAccessPointId.yaml
-
 ResourceURL:
   $ref: ./ResourceURL.yaml
-
 Timestamp:
   $ref: ./Timestamp.yaml
-        
 Timezone:
   $ref: ./Timezone.yaml
-
 UserEventCriteria:
   $ref: ./UserEventCriteria.yaml
-
 UserEventType:
   $ref: ./UserEventType.yaml
-
 UserInfo:
   $ref: ./UserInfo.yaml
-
 UserList:
   $ref: ./UserList.yaml
-
 UserTrackingSubscription:
   $ref: ./UserTrackingSubscription.yaml
-
 ZonalPresenceNotification:
   $ref: ./ZonalPresenceNotification.yaml
-
 ZonalTrafficSubscription:
   $ref: ./ZonalTrafficSubscription.yaml
-
 ZoneId:
   $ref: ./ZoneId.yaml
-
 ZoneInfo:
   $ref: ./ZoneInfo.yaml
-
 ZoneList:
   $ref: ./ZoneList.yaml
-
 ZoneStatusNotification:
   $ref: ./ZoneStatusNotification.yaml
-
 ZoneStatusSubscription:
   $ref: ./ZoneStatusSubscription.yaml
\ No newline at end of file
index 132dc24..20a5a1b 100644 (file)
@@ -1,2 +1,2 @@
-  description: "ETSI MEC013 V1.0.1 Location Service API"
-  url: "https://docbox.etsi.org/ISG/MEC/70-Draft/0013LocationApi"
\ No newline at end of file
+description: 'ETSI MEC013 V1.1.1 Location Service API'
+url: 'http://www.etsi.org/deliver/etsi_gs/MEC/001_099/013/01.01.01_60/gs_mec013v010101p.pdf'
\ No newline at end of file
index ba27da5..6cf6a33 100644 (file)
@@ -1,6 +1,6 @@
-  description: "The MEC-013 Location API described using OpenAPI, which is based on the Open Mobile Alliance's specification RESTful Network API for Zonal Presence"
-  version: '1.0.1'
-  title: 'MEC Location API'
-  license:
-    name: ETSI Forge copyright notice
-    url: 'https://forge.etsi.org/etsi-forge-copyright-notice.txt'
\ No newline at end of file
+title: 'Location API'
+version: '1.1.1'
+description: "The ETSI MEC ISG MEC012 Location API described using OpenAPI. The API is based on the Open Mobile Alliance's specification RESTful Network API for Zonal Presence"
+license:
+  name: ETSI Forge copyright notice
+  url: 'https://forge.etsi.org/etsi-forge-copyright-notice.txt'
\ No newline at end of file
diff --git a/parameters/AccessPointId.yaml b/parameters/AccessPointId.yaml
deleted file mode 100644 (file)
index 06c6497..0000000
+++ /dev/null
@@ -1,6 +0,0 @@
-name: accessPointId
-in: query
-description: >-
-  Identifier of access point, reference "definitions" for string format
-required: false
-type: string
\ No newline at end of file
diff --git a/parameters/Body.UserTrackingSubscription.yaml b/parameters/Body.UserTrackingSubscription.yaml
new file mode 100644 (file)
index 0000000..62164ae
--- /dev/null
@@ -0,0 +1,6 @@
+name: userTrackingSubscription
+in: body
+description: User Tracking Subscription
+required: true
+schema: 
+  $ref: '#/definitions/UserTrackingSubscription'
\ No newline at end of file
diff --git a/parameters/Body.ZonalTrafficSubscription.yaml b/parameters/Body.ZonalTrafficSubscription.yaml
new file mode 100644 (file)
index 0000000..b33fcef
--- /dev/null
@@ -0,0 +1,6 @@
+name: zonalTrafficSubscription
+in: body
+description: Zonal Traffic Subscription
+required: true
+schema:
+  $ref: '#/definitions/ZonalTrafficSubscription'
\ No newline at end of file
diff --git a/parameters/Body.ZoneStatusSubscription.yaml b/parameters/Body.ZoneStatusSubscription.yaml
new file mode 100644 (file)
index 0000000..7dfc296
--- /dev/null
@@ -0,0 +1,6 @@
+name: zoneStatusSubscription
+in: body
+description: Zone Status Subscription
+required: true
+schema: 
+  $ref: '#/definitions/ZoneStatusSubscription'
\ No newline at end of file
diff --git a/parameters/InterestRealm.yaml b/parameters/InterestRealm.yaml
deleted file mode 100644 (file)
index 72fb89c..0000000
+++ /dev/null
@@ -1,5 +0,0 @@
-name: interestRealm
-in: query
-description: Interest realm of access point (e.g. geographical area, a type of industry etc.).
-required: false
-type: string
\ No newline at end of file
diff --git a/parameters/Path.AccessPointId.yaml b/parameters/Path.AccessPointId.yaml
new file mode 100644 (file)
index 0000000..d1f4b57
--- /dev/null
@@ -0,0 +1,5 @@
+name: accessPointId
+in: path
+description: Access Point ID
+required: true
+type: string
\ No newline at end of file
diff --git a/parameters/Path.SubscriptionId.yaml b/parameters/Path.SubscriptionId.yaml
new file mode 100644 (file)
index 0000000..9d9f9d0
--- /dev/null
@@ -0,0 +1,5 @@
+name: subscriptionId
+in: path
+description: Subscription ID
+required: true
+type: string
\ No newline at end of file
diff --git a/parameters/Path.UserId.yaml b/parameters/Path.UserId.yaml
new file mode 100644 (file)
index 0000000..720237f
--- /dev/null
@@ -0,0 +1,5 @@
+name: userId
+in: path
+description: User ID
+required: true
+type: string
\ No newline at end of file
diff --git a/parameters/Path.ZoneId.yaml b/parameters/Path.ZoneId.yaml
new file mode 100644 (file)
index 0000000..8d2c719
--- /dev/null
@@ -0,0 +1,5 @@
+name: zoneId
+in: path
+description: Zone ID
+required: true
+type: string
\ No newline at end of file
diff --git a/parameters/Query.AccessPointId.yaml b/parameters/Query.AccessPointId.yaml
new file mode 100644 (file)
index 0000000..06c6497
--- /dev/null
@@ -0,0 +1,6 @@
+name: accessPointId
+in: query
+description: >-
+  Identifier of access point, reference "definitions" for string format
+required: false
+type: string
\ No newline at end of file
diff --git a/parameters/Query.InterestRealm.yaml b/parameters/Query.InterestRealm.yaml
new file mode 100644 (file)
index 0000000..72fb89c
--- /dev/null
@@ -0,0 +1,5 @@
+name: interestRealm
+in: query
+description: Interest realm of access point (e.g. geographical area, a type of industry etc.).
+required: false
+type: string
\ No newline at end of file
diff --git a/parameters/Query.ZoneId.yaml b/parameters/Query.ZoneId.yaml
new file mode 100644 (file)
index 0000000..1515905
--- /dev/null
@@ -0,0 +1,5 @@
+name: zoneId
+in: query
+description: Zone ID
+required: true
+type: string
\ No newline at end of file
diff --git a/parameters/ZoneId.yaml b/parameters/ZoneId.yaml
deleted file mode 100644 (file)
index 1515905..0000000
+++ /dev/null
@@ -1,5 +0,0 @@
-name: zoneId
-in: query
-description: Zone ID
-required: true
-type: string
\ No newline at end of file
index 249147f..79aa650 100644 (file)
@@ -1,6 +1,20 @@
-ZoneId:
-  $ref: ./ZoneId.yaml
-AccessPointId:
-  $ref: ./AccessPointId.yaml
-InterestRealm:
-  $ref: ./InterestRealm.yaml
\ No newline at end of file
+Body.UserTrackingSubscription:
+  $ref: ./Body.UserTrackingSubscription.yaml
+Body.ZonalTrafficSubscription:
+  $ref: ./Body.ZonalTrafficSubscription.yaml
+Body.ZoneStatusSubscription:
+  $ref: ./Body.ZoneStatusSubscription.yaml
+Path.AccessPointId:
+  $ref: ./Path.AccessPointId.yaml
+Path.SubscriptionId:
+  $ref: ./Path.SubscriptionId.yaml
+Path.UserId:
+  $ref: ./Path.UserId.yaml
+Path.ZoneId:
+  $ref: ./Path.ZoneId.yaml
+Query.AccessPointId:
+  $ref: ./Query.AccessPointId.yaml
+Query.InterestRealm:
+  $ref: ./Query.InterestRealm.yaml
+Query.ZoneId:
+  $ref: ./Query.ZoneId.yaml
index 0752b6a..7666584 100644 (file)
@@ -3,11 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.SubscriptionId'
 
 responses:
   204:
index 8ec55f7..07445e7 100644 (file)
@@ -3,11 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.SubscriptionId'
 
 responses:
   200:
index 845be5e..ab57b48 100644 (file)
@@ -3,17 +3,8 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
-- name: userTrackingSubscription
-  in: body
-  description: User Tracking Subscription
-  required: true
-  schema: 
-    $ref: '#/definitions/UserTrackingSubscription'
+- $ref: '#/parameters/Path.SubscriptionId'
+- $ref: '#/parameters/Body.UserTrackingSubscription'
 
 responses:
   200:
index d1c7021..8097c74 100644 (file)
@@ -3,12 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: userTrackingSubscription
-  in: body
-  description: User Tracking Subscription
-  required: true
-  schema: 
-    $ref: '#/definitions/UserTrackingSubscription'
+- $ref: '#/parameters/Body.UserTrackingSubscription'
 
 responses:
   201:
index 08e1dc2..69317c2 100644 (file)
@@ -3,11 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.SubscriptionId'
 
 responses:
   204:
index 7db22b1..904eef9 100644 (file)
@@ -3,11 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.SubscriptionId'
 
 responses:
   200:
index 10a84a3..41cc486 100644 (file)
@@ -3,17 +3,8 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
-- name: zonalTrafficSubscription
-  in: body
-  description: Zonal Traffic Subscription
-  required: true
-  schema: 
-    $ref: '#/definitions/ZonalTrafficSubscription'
+- $ref: '#/parameters/Path.SubscriptionId'
+- $ref: '#/parameters/Body.ZonalTrafficSubscription'
 
 responses:
   200:
index 37332ca..ad5f2bc 100644 (file)
@@ -3,12 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: zonalTrafficSubscription
-  in: body
-  description: Zonal Traffic Subscription
-  required: true
-  schema: 
-    $ref: '#/definitions/ZonalTrafficSubscription'
+- $ref: '#/parameters/Body.ZonalTrafficSubscription'
       
 responses:
   201:
index 4f330a3..7507a83 100644 (file)
@@ -2,4 +2,7 @@ get:
   $ref: ./SubsZoneStatId_Get.yaml
 
 put:
-  $ref: ./SubsZoneStatId_Put.yaml
\ No newline at end of file
+  $ref: ./SubsZoneStatId_Put.yaml
+
+delete:
+  $ref: ./SubsZoneStatId_Del.yaml
\ No newline at end of file
index 08e1dc2..69317c2 100644 (file)
@@ -3,11 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.SubscriptionId'
 
 responses:
   204:
index 30b2cbd..bf09fe0 100644 (file)
@@ -3,11 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.SubscriptionId'
 
 responses:
   200:
index a4358d9..1188324 100644 (file)
@@ -3,17 +3,8 @@ description:
 produces:
 - application/json
 parameters:
-- name: subscriptionId
-  in: path
-  description: Subscription ID
-  required: true
-  type: string
-- name: zoneStatusSubscription
-  in: body
-  description: Zone Status Subscription
-  required: true
-  schema: 
-    $ref: '#/definitions/ZoneStatusSubscription'
+- $ref: '#/parameters/Path.SubscriptionId'
+- $ref: '#/parameters/Body.ZoneStatusSubscription'
 
 responses:
   200:
index 527f156..eccb634 100644 (file)
@@ -3,13 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: zoneStatusSubscription
-  in: body
-  description: Zone Status Subscription
-  required: true
-  schema: 
-    $ref: '#/definitions/ZoneStatusSubscription'
-
+- $ref: '#/parameters/Body.ZoneStatusSubscription'
 
 responses:
   201:
index 0dc6e99..f661b4a 100644 (file)
@@ -3,11 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: userId
-  in: path
-  description: User ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.UserId'
   
 responses:
   200:
index bce8763..2d57527 100644 (file)
@@ -3,8 +3,8 @@ description:
 produces:
 - application/json
 parameters:
-- $ref: '#/parameters/ZoneId'
-- $ref: '#/parameters/AccessPointId'
+- $ref: '#/parameters/Query.ZoneId'
+- $ref: '#/parameters/Query.AccessPointId'
 
 responses:
   200:
index 9ed91cd..e592eb8 100644 (file)
@@ -3,16 +3,8 @@ description:
 produces:
 - application/json
 parameters:
-- name: zoneId
-  in: path
-  description: Zone ID
-  required: true
-  type: string
-- name: accessPointId
-  in: path
-  description: Access Point ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.ZoneId'
+- $ref: '#/parameters/Path.AccessPointId'
 
 responses:
   200:
index 7edf33c..a00ac7f 100644 (file)
@@ -3,12 +3,8 @@ description:
 produces:
 - application/json
 parameters:
-- name: zoneId
-  in: path
-  description: Zone ID
-  required: true
-  type: string
-- $ref: '#/parameters/InterestRealm'
+- $ref: '#/parameters/Path.ZoneId'
+- $ref: '#/parameters/Query.InterestRealm'
 
 responses:
   200:
index 24d9b3b..ba5f74b 100644 (file)
@@ -3,11 +3,7 @@ description:
 produces:
 - application/json
 parameters:
-- name: zoneId
-  in: path
-  description: Zone ID
-  required: true
-  type: string
+- $ref: '#/parameters/Path.ZoneId'
 
 responses:
   200:
index 7682663..bc7abc4 100644 (file)
@@ -12,53 +12,4 @@ responses:
       
     examples:
       application/json:
-        $ref: '../examples/ZoneList.json'
-
-# works, but what does it add?!
-#      application/json:
-#        $ref: '../examples/index.yaml#/ZonesGetResponse'
-
-# works
-#      application/json:
-#        $ref: '../examples/ZonesGetResponse.json'
-
-# works
-#      application/json:
-#        {
-#              "zoneList": {
-#                      "zone": 
-#                      [
-#                        {
-#                                      "zoneId": "zone01",
-#                                      "numberOfAccessPoints": "3",
-#                                      "numberOfUnserviceableAccessPoints": "1",
-#                                      "numberOfUsers": "10",
-#                                      "resourceURL": "http://example.com/exampleAPI/location/v1/zones/zone01"
-#                              }, 
-#                              {
-#                                      "zoneId": "zone02",
-#                                      "numberOfAccessPoints": "12",
-#                                      "numberOfUnserviceableAccessPoints": "0",
-#                                      "numberOfUsers": "36",
-#                                      "resourceURL": "http://example.com/exampleAPI/location/v1/zones/zone02"
-#                              }
-#                      ],
-#                      "resourceURL": "http://example.com/exampleAPI/location/v1/zones"
-#              }            
-#        } 
-
-# works
-#      application/json:
-#        zoneList:
-#          zone:
-#          - zoneId: zone01
-#            numberOfAccessPoints: '3'
-#            numberOfUnserviceableAccessPoints: '1'
-#            numberOfUsers: '10'
-#            resourceURL: http://example.com/exampleAPI/location/v1/zones/zone01
-#          - zoneId: zone02
-#            numberOfAccessPoints: '12'
-#            numberOfUnserviceableAccessPoints: '0'
-#            numberOfUsers: '36'
-#            resourceURL: http://example.com/exampleAPI/location/v1/zones/zone02
-#          resourceURL: http://example.com/exampleAPI/location/v1/zones
\ No newline at end of file
+        $ref: '../examples/ZoneList.json'
\ No newline at end of file