From the restlet home page "Do you want to blend your web services, web sites and web clients into
unified web applications exposing and consuming RESTful web APIs?"
The link I provided was to an example of using restlet on the client side. I would agree that the api is not as human friendly as it could be but it does describe interactions in a restful which is why I suggested it would be a good starting point for writing a friendly api.
I think the parent poster is looking for a client API that is nicer to use than java.net.Url and/or the various versions of HTTPClient