# 2. Запрос и ответ

В руководстве [Привет, NATS](/tutorials/hello-nats.md) издатель отправлял сообщение без ответа. Теперь вы создадите двусторонний обмен: небольшой **отвечающий сервис**, который отвечает на вопросы в теме, и **запрос**, который обращается к нему и получает ровно один ответ. В результате вы запустите сервис `time` в одном терминале и спросите у него время из другого.

**Движение сообщений — Запрос / Ответ:** Запрос-ответ: клиент отправляет запрос и ждёт ответа сервиса

* Клиент → NATS (тема: get.user.150)
* NATS → Сервис (тема: get.user.150)
* Сервис → NATS (тема: \_INBOX.\<nuid>)
* NATS → Клиент (тема: \_INBOX.\<nuid>)

## Что понадобится

* CLI `nats` и работающий `nats-server` из руководства [Привет, NATS](/tutorials/hello-nats.md). Если сервер не работает, запустите его:

  ```
  nats-server
  ```

* Два терминала: один для сервиса, другой для запроса.

## Шаг 1: запустите отвечающий сервис

В первом терминале запустите сервис на теме `time`. Флаг `--command` указывает команде `nats reply` запускать программу для каждого запроса и отправлять её вывод в качестве ответа.

#### CLI

```
#!/bin/bash

# Запустите отвечающий сервис в теме "time". `nats reply` подписывается на

# тему и для каждого запроса выполняет команду, отправляя её

# вывод в отдельную тему ответа запроса. Оставьте сервис работать.

nats reply time --command "date"
```

#### C

```
// Answer every request on "time" with the current date and time, sent

// back on the request's private reply subject.

static void

onRequest(natsConnection *nc, natsSubscription *sub, natsMsg *msg, void *closure)

{

    char   now[64];

    time_t t = time(NULL);



    strftime(now, sizeof(now), "%a %b %e %H:%M:%S %Z %Y", localtime(&t));

    if (natsMsg_GetReply(msg) != NULL)

        natsConnection_PublishString(nc, natsMsg_GetReply(msg), now);



    natsMsg_Destroy(msg);

}

    // Subscribe on "time" and leave the responder running; Ctrl-C to stop.

    if (s == NATS_OK)

        s = natsConnection_Subscribe(&sub, conn, "time", onRequest, NULL);
```

Сервис должен запуститься и перейти в ожидание:

```
17:42:10 Listening on "time" in group "NATS-RPLY-22"
```

Оставьте этот терминал работающим. Сервис готов отвечать на запросы.

## Шаг 2: отправьте запрос

Откройте второй терминал и вызовите сервис. Команда `nats request` публикует одно сообщение в `time` и ожидает один ответ в течение глобального `--timeout` (по умолчанию пять секунд).

#### CLI

```
#!/bin/bash

# Отправьте один запрос сервису. `nats request` создаёт отдельный inbox, подписывается

# на него, публикует пустой запрос в "time" с адресом inbox для ответа и

# выводит первый полученный ответ. --timeout задаёт максимальное время ожидания.

nats request time "" --timeout 2s
```

#### C

```
// Call the responder once. The client creates a private inbox,

// publishes an empty request on "time" with the inbox attached, and

// waits up to two seconds for the first reply.

natsMsg *reply = NULL;



s = natsConnection_RequestString(&reply, conn, "time", "", 2000);

if (s == NATS_OK)

{

    printf("received: %.*s\n",

           natsMsg_GetDataLength(reply), natsMsg_GetData(reply));

    natsMsg_Destroy(reply);

}

else if (s == NATS_NO_RESPONDERS)

{

    // Nobody is subscribed to "time": the server says so right away

    // instead of letting the request wait out the timeout.

    printf("no responders are available\n");

}
```

Должен появиться один ответ — текущие дата и время от сервиса:

```
17:42:31 Sending request on "time"

17:42:31 Received with rtt 612µs

Mon Jun  9 17:42:31 CEST 2026
```

Эта дата получена от команды `date`, запущенной сервисом, и отправлена обратно в ответ на ваш запрос.

## Шаг 3: проверьте запись вызова в журнале сервиса

Вернитесь к первому терминалу. Вы должны увидеть запись вызова:

```
17:42:31 [#0] Received on subject "time":
```

При каждом повторном запросе из второго терминала счётчик увеличивается на единицу (`[#1]`, `[#2]`, …), и приходит новый ответ. Повторите запрос несколько раз.

## Шаг 4: проверьте поведение без отвечающего сервиса

Остановите сервис в первом терминале с помощью `Ctrl+C`, затем снова отправьте запрос из второго:

```
nats request time "" --timeout 2s
```

Запрос завершится сразу, не дожидаясь тайм-аута: сервер знает, что на `time` никто не подписан:

```
17:43:02 No responders are available
```

Запустите сервис снова — тот же запрос выполнится успешно.

## Что вы создали

Вы запустили отвечающий сервис `time` и обратились к нему через запрос, получая ровно один ответ на каждый вызов. Всё взаимодействие идёт через NATS, и сторонам не нужно знать адреса друг друга.

## Дальше

* Следующее руководство: [3. Очередь заданий](/tutorials/work-queue.md) — распределите работу между несколькими обработчиками так, чтобы каждое сообщение получал только один.
* Как это работает: [Core NATS → Запрос-ответ](/learn/core-nats/request-reply.md) объясняет inbox, тайм-ауты и сигнал отсутствия отвечающих сервисов.
* Превратите отвечающие приложения в обнаруживаемые сервисы со статистикой и схемами: [Изучение → Сервисы](/learn/services/.md).
