Incollare lo schema in formato JSON o YAML nel browser
Copiare e incollare lo schema in formato JSON o YAML nel browser.
Versioni (Edition) richieste
| Disponibile in: Lightning Experience |
| Disponibile in: Enterprise Edition, Performance Edition, Unlimited Edition e Developer Edition |
| Autorizzazioni utente richieste | |
|---|---|
| Per gestire le connessioni: | Personalizza applicazione |
Per registrare una specifica API copiando e incollando lo schema in formato JSON o YAML nel browser:
- Da Imposta in Lightning Experience, immettere Servizi esterni nella casella Ricerca veloce e selezionare Servizi esterni.
- Fare clic su Nuovo servizio esterno.
- Nella pagina Seleziona una fonte API, indicare se si deve importare una specifica API Da Mulesoft Anypoint Platform o Da specifica API. Poiché in questo esempio stiamo utilizzando la nostra specifica, selezionare Da specifica API.
- In Nome servizio esterno, immettere un nome di servizio univoco.
- In Descrizione, immettere una descrizione facoltativa. Una buona descrizione breve può aiutare a distinguere un servizio da un altro in un lungo elenco di servizi.
- Fare clic in Seleziona credenziale denominata e selezionare una credenziale denominata dall'elenco.
- In Schema servizio, selezionare Schema completo. Fornire uno schema completo, valido per OpenAPI 2.0 o 3.0 e compatibile con JSON o YAML.
- Incollare lo schema compatibile con JSON o YAML nel campo di testo fornito.
-
Fare clic su Salva e Avanti. Lo schema caricato viene convalidato da Servizi esterni.
Nota se lo schema include tipi di media non supportati, il sistema visualizza la pagina Associa le operazioni ai tipi di media supportati. Selezionare una mappatura valida per ciascun tipo non supportato come descritto in Mappatura dei tipi di media durante la registrazione. -
Se durante il processo di convalida vengono rilevati uno o più errori, un messaggio (o una serie di messaggi) fornisce i dettagli specifici dell'errore. Gli utenti possono apportare correzioni allo schema modificandolo direttamente nell'editor di testo e facendo clic su Convalida per confermare le modifiche oppure modificando una copia offline e registrandola nuovamente. Esistono due tipi di errori:
- Errori di sintassi o logici: devono essere corretti per completare il processo di registrazione. Per risolvere un errore, utilizzare il messaggio di errore per individuare il tipo e la posizione dell'errore. Apportare le correzioni e fare clic su Convalida. I messaggi relativi a errori di sintassi specificano la posizione del numero di riga e di colonna.
- Avvertenze di sintassi o di logica: non è necessario correggere gli avvisi per completare una registrazione. Tuttavia, i componenti dello schema corrispondenti vengono ignorati da Servizi esterni e non vengono registrati. Per correggere le avvertenze, utilizzare le indicazioni nel messaggio di avviso, apportare le correzioni e fare clic su Convalida.
- Selezionare le operazioni che si desidera importare nella registrazione del servizio esterno. È possibile selezionare fino a 3.000 operazioni per organizzazione e fino a 3.000 oggetti attivi per organizzazione. Se si supera uno di questi limiti, suddividere le operazioni nello schema in registrazioni separate. Per informazioni sui limiti, vedere Considerazioni sui servizi esterni. Per informazioni sugli "oggetti" degli schemi Open API, vedere Basic Structure (OpenAPI 2.0) e Basic Structure (OpenAPI 3.0)
- Fare clic su Avanti.
- Fare clic su Chiudi.
Questo articolo ha risolto il problema?
Facci sapere, così possiamo migliorare!
