github.com/go-swagger/go-swagger@v0.31.0/fixtures/bugs/2919/edge-api/client/current-api-session-certificates.yml (about)

     1  ---
     2  paths:
     3    current-api-session-certificates:
     4      get:
     5        summary: List the ephemeral certificates available for the current API Session
     6        description: Retrieves a list of certificate resources for the current API session; supports filtering, sorting, and pagination
     7        security:
     8          - ztSession: [ ]
     9        tags:
    10          - Current API Session
    11        operationId: listCurrentApiSessionCertificates
    12        parameters:
    13          - $ref: '../shared/parameters.yml#/limit'
    14          - $ref: '../shared/parameters.yml#/offset'
    15          - $ref: '../shared/parameters.yml#/filter'
    16        responses:
    17          '200':
    18            $ref: '#/responses/listCurrentApiSessionCertificates'
    19          '401':
    20            $ref: '../shared/standard-responses.yml#/responses/unauthorizedResponse'
    21          '400':
    22            $ref: '../shared/standard-responses.yml#/responses/badRequestResponse'
    23      post:
    24        summary: Creates an ephemeral certificate for the current API Session
    25        description: Creates an ephemeral certificate for the current API Session. This endpoint
    26          expects a PEM encoded CSRs to be provided for fulfillment as a property of a JSON payload.
    27          It is up to the client to manage the private key backing the CSR request.
    28        security:
    29          - ztSession: [ ]
    30        tags:
    31          - Current API Session
    32        operationId: createCurrentApiSessionCertificate
    33        parameters:
    34          - name: sessionCertificate
    35            in: body
    36            required: true
    37            description: The payload describing the CSR used to create a session certificate
    38            schema:
    39              $ref: '#/definitions/currentApiSessionCertificateCreate'
    40        responses:
    41          '201':
    42            $ref: '#/responses/createCurrentApiSessionCertificateResponse'
    43          '400':
    44            $ref: '../shared/standard-responses.yml#/responses/badRequestResponse'
    45          '401':
    46            $ref: '../shared/standard-responses.yml#/responses/unauthorizedResponse'
    47    current-api-session-certificates-id:
    48      parameters:
    49        - $ref: '../shared/parameters.yml#/id'
    50      get:
    51        summary: Retrieves an ephemeral certificate
    52        description: Retrieves a single ephemeral certificate by id
    53        security:
    54          - ztSession: [ ]
    55        tags:
    56          - Current API Session
    57        operationId: detailCurrentApiSessionCertificate
    58        responses:
    59          '200':
    60            $ref: '#/responses/detailCurrentApiSessionCertificate'
    61          '404':
    62            $ref: '../shared/standard-responses.yml#/responses/notFoundResponse'
    63          '401':
    64            $ref: '../shared/standard-responses.yml#/responses/unauthorizedResponse'
    65      delete:
    66        summary: Delete an ephemeral certificate
    67        description: |
    68          Delete an ephemeral certificateby id
    69        security:
    70          - ztSession: [ ]
    71        tags:
    72          - Current API Session
    73        operationId: deleteCurrentApiSessionCertificate
    74        responses:
    75          '200':
    76            $ref: '../shared/standard-responses.yml#/responses/deleteResponse'
    77          '400':
    78            $ref: '../shared/standard-responses.yml#/responses/badRequestResponse'
    79          '401':
    80            $ref: '../shared/standard-responses.yml#/responses/unauthorizedResponse'
    81  
    82  responses:
    83    listCurrentApiSessionCertificates:
    84      description: A list of the current API Session's certificate
    85      schema:
    86        $ref: '#/definitions/listCurrentAPISessionCertificatesEnvelope'
    87    createCurrentApiSessionCertificateResponse:
    88      description: A response of a create API Session certificate
    89      schema:
    90        $ref: '#/definitions/createCurrentApiSessionCertificateEnvelope'
    91    detailCurrentApiSessionCertificate:
    92      description: A response containing a single API Session certificate
    93      schema:
    94        $ref: '#/definitions/detailCurrentApiSessionCertificateEnvelope'
    95  
    96  definitions:
    97    listCurrentAPISessionCertificatesEnvelope:
    98      required:
    99        - meta
   100        - data
   101      properties:
   102        meta:
   103          $ref: '../shared/standard-responses.yml#/definitions/meta'
   104        data:
   105          $ref: '#/definitions/currentApiSessionCertificateList'
   106    createCurrentApiSessionCertificateEnvelope:
   107      required:
   108        - meta
   109        - data
   110      properties:
   111        meta:
   112          $ref: '../shared/standard-responses.yml#/definitions/meta'
   113        data:
   114          $ref: '#/definitions/currentApiSessionCertificateCreateResponse'
   115    detailCurrentApiSessionCertificateEnvelope:
   116      required:
   117        - meta
   118        - data
   119      properties:
   120        meta:
   121          $ref: '../shared/standard-responses.yml#/definitions/meta'
   122        data:
   123          $ref: '#/definitions/currentApiSessionCertificateDetail'
   124    currentApiSessionCertificateList:
   125      type: array
   126      items:
   127        $ref: '#/definitions/currentApiSessionCertificateDetail'
   128    currentApiSessionCertificateDetail:
   129      type: object
   130      allOf:
   131        - $ref: '../shared/base-entity.yml#/definitions/baseEntity'
   132        - type: object
   133          required:
   134            - subject
   135            - fingerprint
   136            - validFrom
   137            - validTo
   138            - certificate
   139          properties:
   140            subject:
   141              type: string
   142            fingerprint:
   143              type: string
   144            validFrom:
   145              type: string
   146              format: date-time
   147            validTo:
   148              type: string
   149              format: date-time
   150            certificate:
   151              type: string
   152    currentApiSessionCertificateCreate:
   153      type: object
   154      required:
   155        - csr
   156      properties:
   157        csr:
   158          type: string
   159    currentApiSessionCertificateCreateResponse:
   160      allOf:
   161        - $ref: '../shared/standard-responses.yml#/definitions/createLocation'
   162        - type: object
   163          required:
   164            - certificate
   165          properties:
   166            certificate:
   167              type: string
   168            cas:
   169              type: string