Commit ed669390 authored by moscatelli's avatar moscatelli
Browse files

SOL003_225/SOL003_27/SOL003_228: Individual subscription methods updated

parent 23cb56d3
Loading
Loading
Loading
Loading
Loading
+37 −23
Original line number Diff line number Diff line
@@ -1298,9 +1298,7 @@ paths:
  '/subscriptions':
    post:
      description: >
        Subscribe


        Subscribe.
        The POST method creates a new subscription.
        This method shall follow the provisions specified in the tables
        10.4.7.3.1-1 and 10.4.7.3.1-2 for URI query parameters, request
@@ -1414,8 +1412,8 @@ paths:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/405"
        406:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/406"
        416:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/416"
        422:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/422"
        500:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/500"
        503:
@@ -1524,15 +1522,18 @@ paths:
        404:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/404"
        405:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/404"
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/405"
        406:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/406"
        416:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/416"
        422:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/422"
        500:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/500"
        503:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/503"
        504:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/504"

  ###############################################################################
  # Individual subscription                                                     #
  ###############################################################################
@@ -1544,17 +1545,18 @@ paths:
          Identifier of this subscription.
          This identifier can be retrieved from the resource referenced by
          the "Location" HTTP header in the response to a POST request
          creating a new subscription resource. It can also be retrieved from
          creating a new "Individual subscription" resource. It can also be retrieved from
          the "id" attribute in the payload body of that response.
        in: path
        type: string
        required: true
    get:
      description: >
        Query Subscription Information


        Query Subscription Information.
        The GET method reads an individual subscription.
        This method shall follow the provisions specified in the tables
        10.4.8.3.2-1 and 10.4.8.3.2-2 for URI query parameters,
        request and response data structures, and response codes.
      parameters:
        - name: Accept
          description: >
@@ -1581,7 +1583,8 @@ paths:
          description: >
            200 OK

            Representation of the subscription resource.
            Shall be returned when information about an individual subscription has been read successfully.
            The response body shall contain a representation of the "Individual subscription" resource.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
@@ -1613,21 +1616,30 @@ paths:
        404:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/404"
        405:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/404"
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/405"
        406:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/406"
        416:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/416"
        422:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/422"
        500:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/500"
        503:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/503"
        504:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/504"

    delete:
      description: >
        Terminate subscription


        Terminate subscription.
        The DELETE method terminates an individual subscription.
        This method shall follow the provisions specified in the tables 10.4.8.3.5-1 and 10.4.8.3.5-2
        for URI query parameters, request and response data structures, and response codes.
        As the result of successfully executing this method, the "Individual subscription" resource
        shall not exist any longer. This means that no notifications for that subscription shall be
        sent to the formerly-subscribed API consumer.

          NOTE: Due to race conditions, some notifications might still be received by the formerly-subscribed
                API consumer for a certain time period after the deletion.
      parameters:
        - name: Authorization
          description: >
@@ -1647,7 +1659,7 @@ paths:
          description: >
            204 NO CONTENT

            The subscription resource was deleted successfully.
            Shall be returned when the "Individual subscription" resource has been deleted successfully.
          headers:
            WWW-Authenticate:
              description: >
@@ -1672,12 +1684,14 @@ paths:
        404:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/404"
        405:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/404"
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/405"
        406:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/406"
        416:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/416"
        422:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/422"
        500:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/500"
        503:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/503"
        504:
          $ref: "../../responses/SOL002SOL003_resp.yaml#/responses/504"
 No newline at end of file