Skip to content

DOC-13120: Convert Search REST APIs to OpenAPI#165

Merged
simon-dew merged 35 commits into
release/7.6from
DOC-13120
May 22, 2025
Merged

DOC-13120: Convert Search REST APIs to OpenAPI#165
simon-dew merged 35 commits into
release/7.6from
DOC-13120

Conversation

@simon-dew
Copy link
Copy Markdown
Contributor

@simon-dew simon-dew commented May 13, 2025

Docs issue: DOC-13120

Docs preview: Search API
Credentials: Preview docs for internal review

For @abhinavdangeti the important things to note are the OpenAPI specs:

⚠️ Must be merged at the same time as the following PR:

@simon-dew
Copy link
Copy Markdown
Contributor Author

Adding @abhinavdangeti as a reviewer for visibility. The PR is still in draft. I'm currently filling in the payload and response descriptions where I can.

Comment thread src/search-nodes/swagger/search-nodes.yaml Outdated
Comment thread src/search-nodes/swagger/search-nodes.yaml Outdated
Comment thread src/search-nodes/swagger/search-nodes.yaml Outdated
Comment thread src/search-nodes/swagger/search-nodes.yaml Outdated
Comment thread src/search-nodes/swagger/search-nodes.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-query/swagger/search-query.yaml Outdated
Comment thread src/search-stats/swagger/search-stats.yaml
Comment thread src/search-stats/swagger/search-stats.yaml Outdated
Comment thread src/search-stats/swagger/search-stats.yaml Outdated
Comment on lines +474 to +475
# patternProperties:
# '(.*:.*:)?avg_grpc_internal_queries_latency':
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why do we have this in here?

Copy link
Copy Markdown
Contributor Author

@simon-dew simon-dew May 22, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

As a reminder for future use. The BUCKET:INDEX: properties would be more accurately described using pattern properties. OpenAPI 3.0.3 doesn't support pattern properties, but JSON schema does, and I believe they are supported in a later version of OpenAPI.

@simon-dew simon-dew merged commit 6a2992c into release/7.6 May 22, 2025
1 check passed
@simon-dew simon-dew deleted the DOC-13120 branch May 22, 2025 13:33
simon-dew added a commit that referenced this pull request Aug 19, 2025
* Add Search Gradle files
* Import Search specs
* Add deprecation notice snippets
* Add header attributes
* Add CSS passthroughs
* Add security partials
* Externalize examples
* Migrate examples from docs-server
* Improve parameter descriptions and examples
* Move nsstats for index into the Stats spec
* Update description of partition APIs
* Standardize API versions
* Explain parameters in examples
* Build output docs
simon-dew added a commit that referenced this pull request Aug 19, 2025
* Add Search Gradle files
* Import Search specs
* Add deprecation notice snippets
* Add header attributes
* Add CSS passthroughs
* Add security partials
* Externalize examples
* Migrate examples from docs-server
* Improve parameter descriptions and examples
* Move nsstats for index into the Stats spec
* Update description of partition APIs
* Standardize API versions
* Explain parameters in examples
* Build output docs
simon-dew added a commit that referenced this pull request Sep 10, 2025
* Add Search Gradle files
* Import Search specs
* Add deprecation notice snippets
* Add header attributes
* Add CSS passthroughs
* Add security partials
* Externalize examples
* Migrate examples from docs-server
* Improve parameter descriptions and examples
* Move nsstats for index into the Stats spec
* Update description of partition APIs
* Standardize API versions
* Explain parameters in examples
* Build output docs
dgnicholson pushed a commit that referenced this pull request Oct 21, 2025
* Add Search Gradle files
* Import Search specs
* Add deprecation notice snippets
* Add header attributes
* Add CSS passthroughs
* Add security partials
* Externalize examples
* Migrate examples from docs-server
* Improve parameter descriptions and examples
* Move nsstats for index into the Stats spec
* Update description of partition APIs
* Standardize API versions
* Explain parameters in examples
* Build output docs
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants