このAPI構造はHATEOASと互換性がありますか？

Question

次のAPIリンクの構造がHATEOASと互換性があるのでしょうか？

特に、エンドポイントの作成/確認が不明です。ユーザーはそこからグループを作成することができますか、それとも/グループに入れるのはいいですか？

残りについてのご意見は？また、HAL互換でなければなりません。

/groups 
    /create 
    /detail/{groupId} 
    /update 
    /delete 
    /items 
    /search{?page,size,sort} 

Answer 1

HATEOAS（Richardson's Maturity Model level 3を参照）すべてのリンクについてです、これはこのようなものになりますHALブラウザとなるよう：

ルート：

{ 
    "_links": { 
    "self": { 
     "href": "/api/root" 
    }, 
    "api:group-add": { 
     "href": "http://apiname:port/api/group" 
    }, 
    "api:group-search": { 
     "href": "http://apiname:port/api/group?pageNumber={pageNumber}&pageSize={pageSize}&sort={sort}" 
    }, 
    "api:group-by-id": { 
     "href": "http://apiname:port/api/group/id" (OR "href": "http://apiname:port/api/group?id={id}") 
    } 
    } 
} 

を追加は、単にそれにPOSTだろう2つのGETメソッドがあります。

ここ

{ 
    "Id" : 1, 
    "Name" : "test", 
    "_links": { 
    "self": { 
     "href": "/api/group/1" (OR "/api/group?id=1") 
    }, 
    "edit": { 
     "href": "http://apiname:port/api/group/1" 
    }, 
    "api:delete": { 
     "href": "http://apiname:port/api/group/1" 
    }, 
    "api:items-query": { 
     "href": "http://apiname:port/api/bonus?groupId=1" 
    } 
    } 
} 

、編集が簡単にPUTとなり、その後、あなたが見る（RESTのレベル2を削除する必要があります：あなたが特定のグループにドリルダウンしたら、次に

（＃1と言います）その同じリンクで）、アイテムに関しては、それらがただのプロパティであるか、別のエンドポイントである場合にはおそらく最もよく分かります。グループを取得している同じ呼び出しで返されるようにそれらを埋め込むことさえできます。