Commit e5c386e2 authored by daniel-gonzalez-sanchez's avatar daniel-gonzalez-sanchez
Browse files

Removing allOf keyword for references to additional components when there are... 

Removing allOf keyword for references to additional components when there are already descriptions. Including  and description fields together despite the sibling issue in OAS 3.0.3.
parent 84ebe49c

ngsi-ld-api.yaml

+9 −17
Original line number Diff line number Diff line
@@ -1453,8 +1453,6 @@ paths: 
            NGSILD-Tenant:

              $ref: '#/components/headers/NGSILD-Tenant'

        '207':

          allOf:

            - $ref: '#/components/responses/MultiStatus.BatchOperationResult'

          description: |

            If only some or none of the entities have been successfully created or updated, a response body containing the

            result of each operation contained in the batch is returned in a BatchOperationResult structure.
@@ -1471,6 +1469,7 @@ paths: 
            is returned in a BatchOperationResult structure.



            Errors can occur whenever a distributed operation is unsupported, fails or times out, see clause 6.3.17.

          $ref: '#/components/responses/MultiStatus.BatchOperationResult'

        '400':

          $ref: '#/components/responses/BadRequest'

  /entityOperations/update:
@@ -1527,8 +1526,6 @@ paths: 
            NGSILD-Tenant:

              $ref: '#/components/headers/NGSILD-Tenant'

        '207':

          allOf:

            - $ref: '#/components/responses/MultiStatus.BatchOperationResult'

          description: |

            If only some or none of the entities have

            been successfully updated, a response
@@ -1558,6 +1555,7 @@ paths: 
            Errors can occur whenever a distributed

            operation is unsupported, fails or times out,

            see clause 6.3.17. 

          $ref: '#/components/responses/MultiStatus.BatchOperationResult'

        '400':

          $ref: '#/components/responses/BadRequest'

  /entityOperations/delete:
@@ -1594,8 +1592,6 @@ paths: 
            NGSILD-Tenant:

              $ref: '#/components/headers/NGSILD-Tenant'

        '207':

          allOf:

            - $ref: '#/components/responses/MultiStatus.BatchOperationResult'

          description: |

            If some or all of the entities have not been successfully deleted, or did not exist,

            a response body containing the result of each operation contained in the batch is returned
@@ -1613,6 +1609,7 @@ paths: 
            fails or times out, see clause 6.3.17.



            Errors can occur whenever a distributed operation is unsupported, fails or times out, see clause 6.3.17.

          $ref: '#/components/responses/MultiStatus.BatchOperationResult'

        '400':

          $ref: '#/components/responses/BadRequest'

  /entityOperations/query:
@@ -1750,8 +1747,6 @@ paths: 
            NGSILD-Tenant:

              $ref: '#/components/headers/NGSILD-Tenant'

        '207':

          allOf:

            - $ref: '#/components/responses/MultiStatus.BatchOperationResult'

          description: |

            If only some or none of the entities have been successfully merged, a response body containing the

            result of each operation contained in the batch is returned in a BatchOperationResult structure.
@@ -1768,6 +1763,7 @@ paths: 
            is returned in a BatchOperationResult structure.



            Errors can occur whenever a distributed operation is unsupported, fails or times out, see clause 6.3.17.

          $ref: '#/components/responses/MultiStatus.BatchOperationResult'

        '400':

          $ref: '#/components/responses/BadRequest'

  /temporal/entities:
@@ -2581,19 +2577,17 @@ paths: 
        '400':

          $ref: '#/components/responses/BadRequest'

        '404':

          allOf:

            $ref: '#/components/responses/NotFound'

          description: |

            It is used when a client provided an

            @context identifier not known to the

            system, see clause 6.3.2. 

          $ref: '#/components/responses/NotFound'

        '422':

          allOf:

            $ref: '#/components/responses/Unprocessable'

          description: |

            It is used when a client indicated an

            @context of type "Cached", see

            clause 6.3.2. 

          $ref: '#/components/responses/Unprocessable'

    delete:

      tags:

        - JSON-LD Context API
@@ -2626,17 +2620,15 @@ paths: 
        '400':

          $ref: '#/components/responses/BadRequest'

        '404':

          allOf:

            $ref: '#/components/responses/NotFound'

          description: |

            It is used when a client provided an

            @context identifier not known to the

            system, see clause 6.3.2. 

          $ref: '#/components/responses/NotFound'

        '503':

          allOf:

            $ref: '#/components/responses/ServiceUnavailable'

          description: |

            It is used when re-downloading fails.

          $ref: '#/components/responses/ServiceUnavailable' 



components:

  headers: