This restriction has been chosen to ensure a working REST server/client
duality. By always working on an interface, both are guaranteed to work
and to result in exactly the same REST protocol. For cases where only
the server is planned to be used, the restriction could in theory be
lifted...

Could you add mention about it in docs? It's very important part.