Documentazione delle REST API in Gateway API - Amazon API Gateway

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Documentazione delle REST API in Gateway API

Per aiutare i clienti a comprendere e utilizzare la tua API, è fondamentale documentarla. Per aiutarti a documentare l'API, API Gateway ti consente di aggiungere e aggiornare il contenuto della guida per le singole entità API come parte integrante del processo di sviluppo dell'API. API Gateway memorizza il contenuto di origine e ti consente di archiviare diverse versioni della documentazione. Puoi associare una versione della documentazione a una fase API, esportare uno snapshot di documentazione specifico della fase in un file OpenAPI esterno e distribuire il file come pubblicazione della documentazione.

Per documentare l'API, è possibile chiamare la REST API di Gateway API, utilizzare un AWS SDK o AWS CLI per Gateway API oppure usare la console Gateway API. Inoltre, puoi importare o esportare le parti della documentazione definite in un file OpenAPI esterno.

Per condividere la documentazione API con gli sviluppatori, puoi utilizzare un portale per sviluppatori. Per un esempio, consulta Integrating ReadMe with API Gateway to Keep Your Developer Hub Up to Date o How to Streamline API Development on Amazon API Gateway Using SmartBear's SwaggerHub nel blog Rete dei partner AWS (APN).