Wat zijn de principes van een uniforme interface?

Principes van de uniforme interface (ook bekend als ontwerpprincipes van RESTful API, hoewel ze ook van toepassing zijn op andere gedistribueerde systemen):

1. Identificatie van bronnen: Elk deel van de informatie dat kan worden aangesproken, moet een unieke identificatie hebben. De client interacteert met de bronnen via deze identificaties.
2. Manipulatie van bronnen via representaties: De client ontvangt een representatie van de bron (bijvoorbeeld in JSON- of XML-formaat) en kan de toestand van de bron wijzigen door de gewijzigde representatie terug te sturen naar de server.
3. Zelfbeschrijvende berichten: Elk bericht tussen client en server moet voldoende informatie bevatten voor volledige interpretatie. De client mag niet vertrouwen op externe informatie of sessiestatus op de server.
4. Hypermedia als de motor van de applicatiestatus (HATEOAS): De server moet hyperkoppelingen (links) in de antwoorden bieden die wijzen op de volgende mogelijke acties of gerelateerde bronnen. De client navigeert door de applicatie door deze links te volgen, in plaats van te vertrouwen op vaste URL's of logica.
5. Client-server architectuur: Duidelijke scheiding van verantwoordelijkheden tussen de client (die de gebruikersinterface beheert en verzoeken initieert) en de server (die gegevens opslaat en verzoeken verwerkt). Deze scheiding verbetert schaalbaarheid en draagbaarheid van de client.
6. Zonder toestand (Stateless): Elk verzoek van de client aan de server moet alle benodigde informatie bevatten zodat de server het kan begrijpen en verwerken. De server bewaart geen informatie over de sessiestatus van de client tussen verzoeken. Dit verhoogt schaalbaarheid en fouttolerantie.

Het naleven van deze principes helpt bij het creëren van schaalbare, flexibele en gemakkelijk te onderhouden gedistribueerde systemen.