Вызов сервисов¶
TDG предоставляет REST API для вызова сервисов, развёрнутых в кластере.
Для вызова сервисов используются POST-запросы на адреса вида /service/<service_name>
.
Аргументы для вызова передаются в параметрах запроса или в виде JSON в теле запроса.
Запрос¶
POST /service/<service_name>?<arguments>
<service_name>
– имя сервиса.<arguments>
– аргументы вызова сервиса.
Аргументы вызова сервиса можно передавать двумя способами:
в параметрах запроса:
<name>=<value>
в теле запроса в формате JSON:
{ "name":"value" }
Аргументы, переданные в параметрах запроса, имеют более высокий приоритет. Все аргументы должны быть переданы одним способом. Нельзя передать часть аргументов в параметрах запроса, а другую часть – в теле.
Если аргумент может принимать значение null
, его можно не передавать.
Ответ¶
Возвращаемое значение сервиса в формате JSON.
Пример¶
Запрос:
POST http://localhost:8081/service/say_hello?name=world×=2
Ответ:
{
"result": "Hello, world! Hello, world!"
}