Dobbiamo definire i nostri requisiti per un'API REST. Quali sono gli strumenti che aiutano a creare un documento che descriverà in modo completo il webservice in modo che possa essere creato da un'altra entità?
Sono uno sviluppatore web RESTful (reale, "HATEOAS", Level 3 REST) ma non ho mai incontrato uno strumento per aiutarmi a definire un servizio. Tuttavia, per scopi generali di diagrammi, mi piace OmniGraffle .
Per essere onesti, penso che un editor di testo, una conoscenza del dominio e del livello di vocabolario e comprensione del destinatario, siano tutto ciò di cui hai veramente bisogno.
Vuoi specificare ogni risorsa e come si relaziona con ogni altra risorsa? Quanto in basso nei dettagli stai cercando di andare?
Leggi altre domande sui tag requirements