问用UML编写Rest webservices？

EN

我猜你这么问是因为你想沟通或记录你的API？

我会选择sequence-diagrams。在大多数情况下，你不需要完全遵循UML2“语法”。通常，白板上的涂鸦足以传达您的Restful api。到目前为止，我还没有看到Restful api完全在UML工具中维护的情况。

快速/脏图的另一个选择是使用HTTP片段，这也有助于通过HTTP记录Restful api：

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、资源表示)，短文本风格的通信非常好用。