I think you are asking if you want to share or document your API?
I would go for sequence diagrams . In most cases, you do not have to be fully compatible with the UML2 syntax. Often there are enough letters on the board to inform Restful api about it. So far I have not seen cases where the Restful api is fully supported in UML tools.
Another quick / dirty diagram option that also helps to document Restful api over HTTP uses HTTP snippets:
Pattern:
> METHOD RESOURCE-URL
>...REQUEST-RESOURCE-PAYLOAD (if there)
< RESPONSE-CODE
< RESPONSE-RESOURCE-PAYLOAD (if there)
Examples:
> GET /items/123
< 200
> POST /items
> ...payload(resource-representation)
< 201
- HTTP ( : , -url, ).