Skip to content

Commit 90e9ca6

Browse files
committed
Add http-query-names-casing rule
1 parent 22b9686 commit 90e9ca6

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

azure/Guidelines.md

+5
Original file line numberDiff line numberDiff line change
@@ -168,6 +168,11 @@ DELETE | Remove the resource | `204-No Content`\; avoid `404-Not Found`
168168
<a href="#http-support-optimistic-concurrency" name="http-support-optimistic-concurrency">:white_check_mark:</a> **DO** support caching and optimistic concurrency by honoring the the `If-Match`, `If-None-Match`, if-modified-since, and if-unmodified-since request headers and by returning the ETag and last-modified response headers
169169

170170
#### HTTP Query Parameters and Header Values
171+
172+
<a href="#http-query-names-casing" name="http-query-names-casing">:white_check_mark:</a> **DO** use camel case for query parameter names.
173+
174+
Note: Certain legacy query parameter names use kebab-casing and are allowed only for backwards compatibility.
175+
171176
Because information in the service URL, as well as the request / response, are strings, there must be a predictable, well-defined scheme to convert strings to their corresponding values.
172177

173178
<a href="#http-parameter-validation" name="http-parameter-validation">:white_check_mark:</a> **DO** validate all query parameter and request header values and fail the operation with `400-Bad Request` if any value fails validation. Return an error response as described in the [Handling Errors](#handling-errors) section indicating what is wrong so customer can diagnose the issue and fix it themselves.

0 commit comments

Comments
 (0)