An OpenAPI document comprises paths, which contain operations.
The OpenAPI connector transforms each operation into a topic.
As the OpenAPI specification does not require a title for each operation, Fluid Topics generates topic titles as follows:
- If the operation has a
summary
field, it becomes the topic title. - In the absence of a
summary
field, theoperationId
field becomes the topic title. - In the absence of a
summary
andoperationId
field, thedescription
field becomes the topic title. -
In the absence of all of the aforementioned fields, the OpenAPI connector generates a title based on the path and operation.
For example: for a
GET /user/{userId}
web service, the title isGetUserUserId
.