Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
about-rest-detailed [2020/01/24 11:17] admin1 [Формат запроса:] |
about-rest-detailed [2020/03/05 08:43] (текущий) admin1 |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
//Оригинал статьи: [[https://github.com/nordic-institute/X-Road/blob/develop/doc/Protocols/pr-rest_x-road_message_protocol_for_rest.md|X-Road: Message Protocol for REST]] // | //Оригинал статьи: [[https://github.com/nordic-institute/X-Road/blob/develop/doc/Protocols/pr-rest_x-road_message_protocol_for_rest.md|X-Road: Message Protocol for REST]] // | ||
+ | //Автор: Владимир Недорослев// | ||
====== REST сервисы в X-Road ====== | ====== REST сервисы в X-Road ====== | ||
Строка 12: | Строка 13: | ||
Участник/Подсистема отправителя указываются в заголовке HTTP. Используемый сервис указывается в самом URL в виде параметров. | Участник/Подсистема отправителя указываются в заголовке HTTP. Используемый сервис указывается в самом URL в виде параметров. | ||
- | Формат запроса: | + | ===== Формат запроса ===== |
- | \\ | ||
{http-request-method} /{protocol-version}/{serviceId}[/path][?query-parameters] | {http-request-method} /{protocol-version}/{serviceId}[/path][?query-parameters] | ||
Строка 26: | Строка 26: | ||
- | ==== Заголовки HTTP запроса ==== | + | ===== Заголовки HTTP запроса ===== |
Строка 33: | Строка 33: | ||
**{client}** — информация о том, кто обращается к сервису. Состоит из следующих частей: | **{client}** — информация о том, кто обращается к сервису. Состоит из следующих частей: | ||
- | [X-Road instance]/[member class]/[member code]/[subsystem code]. | + | [X-Road instance]/[member class]/[member code]/[subsystem code] |
**[Subsystem code]** является не обязательным. | **[Subsystem code]** является не обязательным. | ||
Например:\\ | Например:\\ | ||
Строка 54: | Строка 54: | ||
X-Road-Request-Id: f92591a3-6bf0-49b1-987b-0dd78c034cc3 | X-Road-Request-Id: f92591a3-6bf0-49b1-987b-0dd78c034cc3 | ||
- | ==== Заголовок Accept ==== | + | ===== Заголовок Accept ===== |
Строка 186: | Строка 186: | ||
Пример предполагает, что serviceID привязан к https://petstore.niis.org/. | Пример предполагает, что serviceID привязан к https://petstore.niis.org/. | ||
- | **Обратите внимание: каждый запрос должен содержать аттрибут {protocol-version} (см. ). Например: r1.** | + | **__Обратите внимание:__ каждый запрос должен содержать аттрибут {protocol-version} (см. |
+ | [[about-rest-detailed#Формат запроса|Формат запроса]]).**\\ | ||
+ | **Например:** ''r1'' | ||
===== GET запрос ===== | ===== GET запрос ===== |