|
1 | 1 | [[api-conventions]]
|
2 | 2 | == API conventions
|
3 | 3 |
|
4 |
| -The {es} REST APIs are exposed using JSON over HTTP. The JSON request body must |
5 |
| -be UTF-8 encoded. {es} ignores any other encoding headings sent with a request. |
6 |
| -Responses are also UTF-8 encoded. |
| 4 | +The {es} REST APIs are exposed over HTTP. |
7 | 5 |
|
8 | 6 | The conventions listed in this chapter can be applied throughout the REST
|
9 | 7 | API, unless otherwise specified.
|
@@ -685,17 +683,19 @@ should also be passed with a media type value that indicates the format
|
685 | 683 | of the source, such as `application/json`.
|
686 | 684 |
|
687 | 685 | [discrete]
|
688 |
| -==== Content-Type Requirements |
| 686 | +==== Content-type requirements |
689 | 687 |
|
690 | 688 | The type of the content sent in a request body must be specified using
|
691 | 689 | the `Content-Type` header. The value of this header must map to one of
|
692 | 690 | the supported formats that the API supports. Most APIs support JSON,
|
693 | 691 | YAML, CBOR, and SMILE. The bulk and multi-search APIs support NDJSON,
|
694 | 692 | JSON, and SMILE; other types will result in an error response.
|
695 | 693 |
|
696 |
| -Additionally, when using the `source` query string parameter, the |
697 |
| -content type must be specified using the `source_content_type` query |
698 |
| -string parameter. |
| 694 | +When using the `source` query string parameter, the content type must be |
| 695 | +specified using the `source_content_type` query string parameter. |
| 696 | + |
| 697 | +{es} only supports UTF-8-encoded JSON. {es} ignores any other encoding headings |
| 698 | +sent with a request. Responses are also UTF-8 encoded. |
699 | 699 |
|
700 | 700 | [[url-access-control]]
|
701 | 701 | === URL-based access control
|
|
0 commit comments