3.2.3.Uniform Interface

• Uniform Interface = Communication Contract

• Client and server share a common technical interface

  • Interface

    • Contract for communication between client-server

    • Contract has no business context

    • Contract defined using HTTP methods & media types

• Guiding principles

  • 1.Identity of resources (URI/ URL)

    • e.g. HTTP/1.1 GET http://api.acmetravel.com/Vacations/21/Reviews

  • 2.Representation of the resource

  • 3.Self describing messages - metadata

    • Content-Type

    • HTTP status code

    • Host

    • Accept e.g., application/JSON

  • 4.Hypermedia/ HATEOAS

    • Response = Data + Actions

    • HATEOAS = Hypermedia As The Engine Of Application State