mirror of
https://github.com/elastic/kibana.git
synced 2025-04-25 02:09:32 -04:00
5e90e557cf
## Summary Close https://github.com/elastic/kibana/issues/188926 Adds the ability to merge in an arbitrary OAS operation object (search [spec](https://swagger.io/specification/) for "operation object") in code generated OAS. This enables us to write examples next to the code: <img width="306" alt="Screenshot 2025-02-26 at 11 24 00" src="https://github.com/user-attachments/assets/5df92ae9-c8c5-4797-8b7c-764e937e84e9" /> ```ts // Inside the router declaration router.post( { path: `${BASE_ALERTING_API_PATH}/rule/{id?}`, security: DEFAULT_ALERTING_ROUTE_SECURITY, options: { access: 'public', summary: `Create a rule`, tags: ['oas-tag:alerting'], // NEW 👇🏻: this file can contain operation-level OAS and will merge/override anything that we auto generate oasOperationObject: () => path.join(__dirname, 'create_rule.examples.yaml'), // ☝🏻 can also be a TS-checked OpenAPIV3.OperationObject ``` Tested with create rule example overlay ([gist](https://gist.github.com/jloleysens/dc643522a3f58dc2aed3dcef966b42df)) and bump <img width="1236" alt="Screenshot 2025-02-26 at 11 45 57" src="https://github.com/user-attachments/assets/c21b466a-ddab-49ce-b4ba-a04fd0e6c1b7" /> ## Docs Added developer guide docs to https://docs.elastic.dev/kibana-dev-docs/genereating-oas-for-http-apis#2-route-definitions <details> <summary>images</summary> <img width="799" alt="Screenshot 2025-03-13 at 13 02 31" src="https://github.com/user-attachments/assets/e89b2c5a-1984-4672-a40b-b492581e690f" /> <img width="819" alt="Screenshot 2025-03-13 at 13 02 39" src="https://github.com/user-attachments/assets/1375a25a-4d91-46b4-8ce5-42c763657d96" /> </details> ### TO DO - [x] Document the feature in TS - [x] Document feature in dev docs - [x] Add tests --------- Co-authored-by: kibanamachine <42973632+kibanamachine@users.noreply.github.com> |
||
|---|---|---|
| .. | ||
| data | ||
| performance | ||
| screenshotting | ||
| advanced_settings.mdx | ||
| apm_ui.png | ||
| building_a_kibana_distributable.mdx | ||
| ci.mdx | ||
| configuring_cross_cluster_search.mdx | ||
| data_views.mdx | ||
| debugging.mdx | ||
| debugging_fips_test_failures.mdx | ||
| development_windows.mdx | ||
| endpoints.mdx | ||
| expressions.mdx | ||
| fips_test_failure_license_override_example.png | ||
| generating_oas_for_http_apis.mdx | ||
| kibana_page_template.mdx | ||
| saved_objects.mdx | ||
| submit_a_pull_request.mdx | ||
| testing_plugins.mdx | ||
| versioning_http_apis.mdx | ||
| versioning_interfaces.mdx | ||
