Sono in procinto di delineare la logica aziendale prevista di un servizio web. A questo punto, non sono troppo interessato ai dettagli di implementazione. Al contrario, sto cercando dei modi per astrarli via per descrivere la logica di business ei dati esposti dal servizio web in modo indipendente dall'implementazione.
Ho letto un po 'sui principi fondamentali alla base di REST e GraphQL. I servizi RESTful espongono risorse . GraphQL espone i dati utilizzando Tipi di oggetto .
Questi concetti condividono alcune caratteristiche fondamentali:
- descrivono "cose" (entità) con attributi
- "le cose" possono essere correlate ad altre "cose"
- "cose" supportano un'interfaccia uniforme per interagire con loro: recupero, inserimento, mutazione e cancellazione (almeno in una certa misura, non ho familiarità con le mutazioni in GraphQL)
Potrei mescolare alcuni termini, ma sono nel complesso corretto nel pensare che entrambi siano concettualmente uguali o almeno molto simili?
L'omissione dei dettagli di implementazione dalla documentazione è un mezzo adeguato per "colmare il divario" tra i due (e le possibili variazioni future)?
Esistono standard per documentare le "cose" e il comportamento delle loro operazioni supportate in modo agonistico di implementazione?