Swagger:Problema con il parametro Path

Sto tenta di creare una spavalderia file con il seguente percorso:
percorsi:
/v1/clienti/{id}/riepilogo :

Tuttavia ottengo il seguente errore destra fuori bat:

API richiede percorso di parametro, ma non è definito: id
a percorsi di ▹ /v1/clienti/{id}/riepilogo

Non sembra come il ‘id’ parametro. Può qualcuno dirmi come potrei risolvere il problema?

Se ho il drill down su questo vedo il seguente:

Details
 Object
 swaggerError: Object
 errors: Array [1]
 0: Object
code:  "MISSING_API_PATH_PARAMETER"
message:  "API requires path parameter but it is not defined: id"
data:  "/v1/customers/{id}/summary"
 path: Array [2]
 warnings: Array [0]
  • Che Swagger versione usi? Come si fa a creare la tua spec?
  • Sto usando la Spavalderia 2.0. Sto creando la mia spec da riga di comando da Apigee_127 & compilazione di un file YAML creato nell’editor. Spero che risponde alla domanda.
  • Se ho il drill down su di errore ottengo il seguente:

 

One Reply
  1. 86

    In sostanza, si sta dichiarando un percorso che è un percorso parametro in esso, utilizzando il percorso di modelli. In questo caso {id} dichiara un percorso parametro chiamato id.

    Quando si dichiara tale percorso, significa che si devono dichiarare che il parametro path, come parte dell’operazione.

    Dare un’occhiata a questo YAML esempio:

      /pets/{id}:
        get:
          description: Returns a user based on a single ID, if the user does not have access to the pet
          operationId: findPetById
          produces:
            - application/json
            - application/xml
            - text/xml
            - text/html
          parameters:
            - name: id
              in: path
              description: ID of pet to fetch
              required: true
              type: integer
              format: int64
          responses:
            '200':
              description: pet response
              schema:
                $ref: '#/definitions/pet'
            default:
              description: unexpected error
              schema:
                $ref: '#/definitions/errorModel'
    

    Si può vedere che c’è un {id} nel percorso, e un corrispondente id la definizione dei parametri. Senza di essa, la spec non saranno validi.

    • Grazie mille per la comprensione ha aiutato!!
    • Inoltre, si noti che è necessario e che è necessario essere impostata su true
    • Ciao Ron, si Potrebbe si prega di guardare a questa domanda – stackoverflow.com/questions/42348630/… e fatemi sapere i vostri pensieri su questo
    • Vedo che hai una risposta da Dilip – egli è l’autore di Springfox e la migliore risposta che si vuole ottenere.

Lascia un commento