Запрос доступных постов, каналов поста и их параметров

Запрос доступных постов

get_post-set

Структура URL-запроса get_post-set определяется форматом:

GET /api/v1/post

Если структура URL-запроса get-post-set соответствует требованиям, сервер, после успешной обработки запроса, возвращает ответ с HTTP-кодом 200. Тело ответа содержит application/JSON-документ get_post-set_rbody-200 с параметрами:

  1. "status" :: uint16_t. Содержит 200.

  2. "result" :: char[][37]. Массив. Каждый элемент содержит глобальный идентификатор поста.

Пример get_post-set_rbody-200:

{
 "status": 200,
 "result":
 [
   "a51d1532-466f-490a-8b06-753cfef7de28"
 ]
}

get_post-set2

Структура URL-запроса get_post-set2 определяется форматом:

GET /api/v1/post?full

Сервер, после успешной обработки запроса get_post-set2, возвращает ответ с HTTP-кодом 200. Тело ответа содержит application/JSON-документ get_post-set2_rbody-200 с параметрами:

  1. "status" :: uint16_t. Содержит 200.

  2. "result" :: struct[]. Массив. Каждый элемент содержит параметры поста архива событий.

    1. "Name" :: char[256]. Имя.

    2. "Guid" :: char[37]. Глобальный идентификатор.

Пример get_post-set2_rbody-200:


{
 "status": 200,
 "result":
 [
   {
     "Name": "UA-03",
     "Guid": "a51d1532-466f-490a-8b06-753cfef7de28",
   }
 ]
}

Запрос параметров поста (get_post-args)

Структура URL-запроса get_post-args определяется форматом:

GET /api/v1/post/<post-guid>

где <post-guid> :: char[37] — глобальный идентификатор поста; возможны значения согласно get_post-set_rbody-200 (см. Запрос доступных постов выше).

Пример URL-запроса:

GET /api/v1/post/a51d1532-466f-490a-8b06-753cfef7de28

Сервер, после успешной обработки запроса get_post-args, возвращает ответ с HTTP-кодом 200. Тело ответа содержит application/JSON-документ get_post-args_rbody-200 с параметрами:

  1. "status" :: uint16_t. Содержит 200.

  2. "result" :: struct. Параметры поста архива событий.

    1. "Name" :: char[256]. Имя поста.

    2. "Guid" :: char[37]. Глобальный идентификатор поста.

Пример get_post-args_rbody-200:

{
  "status": 200,
  "result":
  {
    "Name": "UA-03",
    "Guid": "a51d1532-466f-490a-8b06-753cfef7de28"
  }
}

Запрос доступных каналов поста

get_post-channel-set

Структура URL-запроса get_post-channel-set определяется форматом:

GET /api/v1/post/<post-guid>/channel

где <post-guid> — глобальный идентификатор поста.

Если структура URL-запроса get-post-channel-set соответствует требованиям, сервер, после успешной обработки, возвращает ответ с HTTP-кодом 200. Тело ответа содержит application/JSON-документ get_post-channel-set_rbody-200 с параметрами:

  1. "status" :: uint16_t. Содержит 200.

  2. "result" :: int32_t[]. Массив. Каждый элемент содержит номер канала поста архива событий. Элементы массива не упорядочены.

Пример get_post-channel-set_rbody-200:

{
 "status": 200,
 "result": [0]
}

get_post-channel-set2

Структура URL-запроса get_post-channel-set2 определяется форматом:

GET /api/v1/post/<post-guid>/channel?full

где <post-guid>  глобальный идентификатор поста.


Если структура URL-запроса get_post-channel-set2 соответствует требованиям, сервер, после успешной обработки, возвращает ответ с HTTP-кодом 200. Тело ответа содержит application/JSON-документ get_post-channel-set2_rbody-200 с параметрами:
  1. "status" :: uint16_t. Содержит 200.

  2. "result" :: struct[]. Массив. Каждый элемент содержит параметры канала поста.

    1. "PostGuid" :: char[37]. Глобальный идентификатор поста.

    2. "Channel" :: int32_t. Номер канала поста.

Пример get_post-channel-set2_rbody-200:

{
  "status": 200,
  "result":
  [
    {
      "PostGuid": "a51d1532-466f-490a-8b06-753cfef7de28",
      "Channel": 0
    }
  ]
}

Запрос параметров канала поста (get_post-channel)

Структура URL-запроса get_post-channel определяется форматом:

GET /api/v1/post/<post-guid>/channel/<channel-no>

где

  • <post-guid> :: char[37]  глобальный идентификатор поста; возможны значения согласно get_post-set_rbody-200 (см. Запрос доступных постов выше);
  • <channel-no> :: int32_t — номер канала поста; возможны значения согласно get_post-channel-set_rbody-200 (см. Запрос доступных каналов поста выше).

Если структура URL-запроса put-post-channel соответствует требованиям, сервер после успешной обработки возвращает ответ с HTTP-кодом 200. Тело ответа содержит application/JSON-документ get_post-channel_rbody-200 с параметрами:

  1. "status" :: uint16_t. Содержит 200.

  2. "result" :: struct. Параметры канала поста:

    1. "PostGuid" :: char[37]. Глобальный идентификатор поста.

    2. "Channel" :: int32_t. Номер канала поста.

Пример тела ответа:

{
  "status": 200,
  "result":
  {
    "PostGuid": "a51d1532-466f-490a-8b06-753cfef7de28",
    "Channel": 0
  }
}