Creazione di specifiche per API REST in Enterprise Architect

Question

Il mio cliente desidera che crei una specifica per una futura API REST utilizzando Enterprise Architect (SparxSystems). Il deliverable dovrebbe essere un testo ben formattato (può essere html, docx o rtf). Un diagramma di classe dovrebbe dare un'immagine del corpo del messaggio.

L'unica cosa che ho trovato finora era https://github.com/bayeslife/api-add-in, un plugin per EA per generare RAML e altro. Qualcuno ha un approccio migliore?

Answer 1

vi consiglio di usare il servizio postmanerator che generano la documentazione per l'API automaticamente solo salvare le chiamate API di postino in una raccolta e passa questo collettore a questo servizio che genera la documentazione per voi postmanerator link: postmanerator

I spero che la mia risposta sia utile

Answer 2

La presentazione "Modeling Microservices" di Sander Hoogendoorn contiene alcune diapositive interessanti sulla modellazione di un'API REST in Enterprise Architect. La presentazione è disponibile su slideshare.net. La diapositiva più interessante è la diapositiva # 75. Ecco l'immagine mostrata in quella diapositiva:

(Classe nomi degli attributi e sono in olandese Verklaring significa Dichiarazione e Verklaringen significa dichiarazioni Ma il business alla base di questo esempio non è rilevante...)

Sarebbe bello se qualcuno avesse un plugin per Enterprise Architect per convertire questi diagrammi di classe in specifiche Swagger (Open API specs).