Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
about-rest-detailed [2020/01/24 09:34] admin1 [POST запрос с приложением] |
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] | ||
Строка 24: | Строка 26: | ||
- | ==== Заголовки HTTP запроса ==== | + | ===== Заголовки HTTP запроса ===== |
Строка 31: | Строка 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]** является не обязательным. | ||
Например:\\ | Например:\\ | ||
Строка 52: | Строка 54: | ||
X-Road-Request-Id: f92591a3-6bf0-49b1-987b-0dd78c034cc3 | X-Road-Request-Id: f92591a3-6bf0-49b1-987b-0dd78c034cc3 | ||
- | ==== Заголовок Accept ==== | + | ===== Заголовок Accept ===== |
Строка 184: | Строка 186: | ||
Пример предполагает, что serviceID привязан к https://petstore.niis.org/. | Пример предполагает, что serviceID привязан к https://petstore.niis.org/. | ||
- | Обратите внимание: | + | **__Обратите внимание:__ каждый запрос должен содержать аттрибут {protocol-version} (см. |
+ | [[about-rest-detailed#Формат запроса|Формат запроса]]).**\\ | ||
+ | **Например:** ''r1'' | ||
===== GET запрос ===== | ===== GET запрос ===== | ||
Строка 338: | Строка 342: | ||
Параметры - PetId – Id питомца. | Параметры - PetId – Id питомца. | ||
- | **Вызов сервиса напрямую**: | ||
- | curl -X DELETE "https://petstore.niis.org/v2/pets/1124" -H "accept: application/json" | ||
**Вызов сервиса через X-Road**: | **Вызов сервиса через X-Road**: |