Repository navigation
Open
stairwell-inc/gnostic
#6Description
When a request has both path parameters and body: "*", the path parameters are being repeated in the body in the resulting OpenAPI spec.
Note how the following example has name both in parameters and requestBody in the generated openapi spec.
protobuf:
service LibraryService {
rpc MergeShelves(MergeShelvesRequest) return (Shelf) {
option (google.api.http) = {
post: "/v1/{name=shelves/*}:merge"
body: "*"
};
}
}
// Describes the shelf being removed (other_shelf_name) and updated
// (name) in this merge.
message MergeShelvesRequest {
// The name of the shelf we're adding books to.
string name = 1 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference).type = "Shelf"
];
// The name of the shelf we're removing books from and deleting.
string other_shelf_name = 2 [
(google.api.field_behavior) = REQUIRED,
(google.api.resource_reference).type = "Shelf"
];
}openapi spec:
paths:
/v1/shelves/{shelf}:merge:
post:
tags:
- LibraryService
description: |-
Merges two shelves by adding all books from the shelf named
`other_shelf_name` to shelf `name`, and deletes
`other_shelf_name`. Returns the updated shelf.
The book ids of the moved books may not be the same as the original books.
Returns NOT_FOUND if either shelf does not exist.
This call is a no-op if the specified shelves are the same.
operationId: LibraryService_MergeShelves
parameters:
- name: shelf
in: path
description: The shelf id.
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MergeShelvesRequest'
required: true
responses:
"200":
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Shelf'
components:
schemas:
MergeShelvesRequest:
required:
- name
- other_shelf_name
type: object
properties:
name:
type: string
description: The name of the shelf we're adding books to.
other_shelf_name:
type: string
description: The name of the shelf we're removing books from and deleting.
description: Describes the shelf being removed (other_shelf_name) and updated (name) in this merge.According to use_wildcard_in_body, every field not bound by the path template should be mapped to the request body.
So fields that are bound by the path template shouldn't be in the request body.
Proposal:
In these cases, create a new schema named {method_name}RequestBody which doesn't contain the fields bound by the path:
paths:
/v1/shelves/{shelf}:merge:
post:
tags:
- LibraryService
description: |-
Merges two shelves by adding all books from the shelf named
`other_shelf_name` to shelf `name`, and deletes
`other_shelf_name`. Returns the updated shelf.
The book ids of the moved books may not be the same as the original books.
Returns NOT_FOUND if either shelf does not exist.
This call is a no-op if the specified shelves are the same.
operationId: LibraryService_MergeShelves
parameters:
- name: shelf
in: path
description: The shelf id.
required: true
schema:
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/MergeShelvesRequestBody'
required: true
responses:
"200":
description: OK
content:
application/json:
schema:
$ref: '#/components/schemas/Shelf'
components:
schemas:
MergeShelvesRequestBody:
required:
- other_shelf_name
type: object
properties:
other_shelf_name:
type: string
description: The name of the shelf we're removing books from and deleting.
description: Describes the shelf being removed (other_shelf_name) and updated (name) in this merge.There's a PR on my fork that implements this proposal: istvan-hevele#1
Reacted by Nico Haas, Imam Fauzan, Bicky Eric Kantona, overbeck, Valentin Lahaye and Dániel Gulyás
Metadata
Metadata
Assignees
Labels
No labels
Activity
istvan-hevele commentedon Apr 12, 2022
cc @timburks
lebogg commentedon Apr 21, 2022
I also find that quite confusing. Is there an opinion on this from the developers? Thanks!
vallahaye commentedon Jul 16, 2023
Hello everyone,
I also encountered this problem when switching from protoc-gen-openapiv2 to gnostic.
Fully mapped bodies are the core element used to define custom methods within Google's AIP guidelines.
Would it be possible to reprioritize this issue and evaluate istvan-hevele's PR in this regard?
Thank you
protoc-gen-openapi: remove duplicate body params
jagobagascon commentedon Jun 7, 2024
I came across this exact problem and added my own PR to fix it: #444
protoc-gen-openapi: remove duplicate body params
protoc-gen-openapi: remove duplicate body params
protoc-gen-openapi: remove duplicate body params
goulashify commentedon Dec 18, 2024
+1