diff --git a/aep/general/0134/aep.md.j2 b/aep/general/0134/aep.md.j2 index ddc57296..f81991a6 100644 --- a/aep/general/0134/aep.md.j2 +++ b/aep/general/0134/aep.md.j2 @@ -136,9 +136,11 @@ using `PUT`. To illustrate this, consider a `PUT` request to a `Book` resource: +``` PUT /v1/publishers/123/books/456 {"title": "Mary Poppins", "author": "P.L. Travers"} +``` Next consider that the resource is later augmented with a new field (here we add `rating`, and use a protobuf example without loss of generality): diff --git a/aep/general/0159/aep.md.j2 b/aep/general/0159/aep.md.j2 index 9c40654e..a6d7f9e7 100644 --- a/aep/general/0159/aep.md.j2 +++ b/aep/general/0159/aep.md.j2 @@ -37,6 +37,10 @@ guidance in [unreachable resources]. specified with `*` and permit the collection to be specified; a URI pattern **must not** hard-code the `-` character. +{% tab oas %} + +Note: OAS guidance is yet to be written. + {% endtabs %} ### Unique resource lookup diff --git a/aep/general/0193/aep.md.j2 b/aep/general/0193/aep.md.j2 index e5a23af6..e0224bb3 100644 --- a/aep/general/0193/aep.md.j2 +++ b/aep/general/0193/aep.md.j2 @@ -65,10 +65,6 @@ A JSON representation of an error response might look like the following: } ``` -{% tab oas -%} - -The media-type for an error response should be "application/problem+json". - {% tab proto -%} Services **must** return a [`google.rpc.Status`][Status] message when an API @@ -81,6 +77,10 @@ The error response structure defined above **should** be returned in the [`aep.api.ProblemDetails`](https://buf.build/aep/api/docs/main:aep.api#aep.api.ProblemDetails) to define this field. +{% tab oas -%} + +The media-type for an error response should be "application/problem+json". + {% endtabs %} #### Dynamic variables