Definizione di parametri per un percorso

I parametri del percorso possono specificare elementi variabili di un percorso di URL, parametri di query, intestazioni o un corpo di richiesta. I parametri si applicano a tutte le operazioni definite nel percorso. Un parametro Path può essere sovrascritto a livello di operazione ma non può essere rimosso.

Informazioni su questa attività

Nota:

Puoi completare questa attività utilizzando l'applicazione IU API Designer o utilizzando l'IU API Manager basata sul browser.

Un parametro è simile a un'intestazione, con le seguenti differenze:
  • I parametri contengono dati effettivi e sono disponibili per gli utenti finali, le intestazioni contengono metadati associati a una richiesta o risposta e sono nascosti agli utenti finali.
  • Un parametro può avere diverse ubicazioni, la posizione di un'intestazione è sempre impostata su header.
  • Un parametro può avere vari stili di formato, lo stile di un'intestazione è sempre simple.
Per ulteriori informazioni sulle intestazioni, consultare Creazione di un'intestazione.

In qualsiasi momento puoi passare direttamente al codice sorgente YAML sottostante dell' OpenAPI, cliccando Icona origine OpenAPI sull'icona "Sorgente". Per tornare al modulo di progettazione, clicca sull'icona Icona moduloModulo.

Procedura

  1. Apri l'API per la modifica, come descritto in Modifica di una definizione API OpenAPI 3.0.
  2. Espandere Percorsi
  3. Espandere il percorso richiesto, quindi, se sono già definiti uno o più parametri, espandere Parametri.
  4. È possibile creare un nuovo parametro o modificare qualsiasi parametro esistente.
    • Per creare un parametro, clicca sull'icona "Aggiungi" accanto OpenAPI 3.0 Icona di aggiunta API alla voce "Parametri", quindi consulta la sezione "Creazione di un parametro ".
    • Per modificare un parametro esistente, fare clic sul nome del parametro nel riquadro di navigazione, quindi consultare la sezione Modifica di un parametro.