RESTでエンティティ関係を作成する：子IDに投稿して親を作成できますか？

現在、従来の顧客データにアクセスするためのREST APIを設計しています。APIの要素の1つは、ユーザーの資産です。アセットは特定のサービスの下に追加されます。バックエンドAPIは、特定のサービスのユーザーにのみアセットを追加します。したがって、User--Asset関係はありませんが、User-[Service]-Asset関係があります。

URIは次のようになります。

/users/{id}/assets/{id}/services/{id}

APIを使用すると、新しいエントリを作成するためのアセットIDとサービスIDがわかります。私たちが苦労しているのは、この関係の創造です。

簡単な方法の1つは、関係全体を /users/{id}/assets/

POST /users/{id}/assets    
{asset:${id}, service:{id}, attribute1:"{var}", attribute2:"{var}"}

しかし、URIが示すように実際にアセットを作成するのではなく、アセットとサービスの関係を作成します。

別の方法として、次のように関係をアドレス指定するURIにPOSTすることを検討しています。

POST /users/{id}/assets/{id}/service/{id}
{attribute1:"{var}", attribute2:"{var}"}

ただし、この場合、リソースパス/users/{id}/assets/{id}はPOSTの前には存在せず、副作用として作成されます。

まだ存在しないリソースパスへのPOSTはまったく許可されていますか？

あなたの考えをありがとう、

ジェラール。

存在しない関係にユーザーが初めて投稿するときはいつでも、投稿の一部として作成することをお勧めしているようです。

この種のオンアクセス作成パターンが有効で許容可能な開発パターンであるかどうかを質問している場合、答えは「はい」です。これは有効であり、かなり一般的なパターンです。

ここに複数のポイントがあります：最初：新しいIDがすでに存在している可能性があるため、または新しいリソースを作成するときにIDを入力しないでください。生成されたIDでフィードバックを取得するには、リソースを作成する場合、ロケーションヘッダー属性をシステムで設定する必要があることをシステムで作成する必要があることを提案します。

次に、JSONが正しくありません。リソースURIサービス「s」と同様に、アセットオブジェクト内の別のオブジェクトとしてサービスを処理する必要があります。配列として処理する必要があります。

POST /users/{id}/assets    
{asset:${id}, service:{id}, attribute1:"{var}", attribute2:"{var}"}

である必要があります：

POST /users/{id}/assets    
{services:[{ attribute1:"var", attribute2:"var"}]}

この方法で使用する場合

第三に、私はこの方法を設計提案に使用することを好まない。このケースが失敗した場合、アセットまたはサービスの作成中に失敗したことをどのようにして知ることができるか

これは別の考え方です：

POST /relationships
{ relationship:${id}, asset:{id}, service:{id}, user:{id}, data:"some data" }

このようにして、関係をアセット、サービス、ユーザー間の3方向リンクとして定義し、階層関係を意味しません。

その後、次の方法で特定の関係を取得できます。

GET /relationships?id="2144321"

または、次の方法で関係のサブセットを検索します。

GET /relationships?user="43434"

または

GET /relationships?asset="12433"

元の方法は間違っていませんが、このアプローチは、それが誰に使用されるかについてより多くの柔軟性を与えるかもしれません。