Spec-Zone.ru › OpenTSDB

/api/serializers

Этот конечный пункт отображает плагины сериализаторов, загруженные работающим TSD. Предоставляемая информация включает имя, реализованные методы, типы содержимого и методы.

Глаголы

  • GET
  • POST

Запросы

Параметры недоступны; это конечный пункт только для чтения, который просто возвращает данные системы.

Ответ

Ответ представляет собой массив объектов сериализаторов. Каждый объект имеет следующие поля:

Имя поля Тип данных Описание Пример
serializer Строка Имя сериализатора, подходящее для использования в параметре строки запроса serializer=<serializer_name> xml
formatters Массив<Строка> Массив методов или конечных пунктов, которые сериализатор реализует для преобразования данных ответа. Обычно они сопоставляются с конечным пунктом, например, /api/suggest сопоставляется с Suggest. Если сериализатор не реализует определённый метод, будет использоваться метод по умолчанию. Каждое имя также заканчивается поддерживаемой версией API, например, V1 будет поддерживать вызовы API версии 1. "Error","Suggest"
parsers Массив<Строка> Массив методов или конечных пунктов, которые сериализатор реализует для разбора пользовательского ввода в теле запроса HTTP. Обычно они сопоставляются с конечным пунктом, например, /api/suggest будет сопоставляться с Suggest. Если сериализатор не реализует парсер, будет использоваться по умолчанию. Каждое имя также заканчивается поддерживаемой версией API, например, V1 будет поддерживать вызовы API версии 1. "Suggest","Put"

Этот конечный пункт всегда должен возвращать данные с JSON-сериализатором в качестве значения по умолчанию. Если вы считаете, что TSD должен иметь другие перечисленные форматировщики, проверьте документацию плагина, чтобы убедиться, что у вас есть соответствующий плагин, и он находится в правильной папке.

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

[
  {
    "formatters": [
      "SuggestV1",
      "SerializersV1",
      "ErrorV1",
      "ErrorV1",
      "NotFoundV1"
    ],
    "serializer": "json",
    "parsers": [
      "SuggestV1"
    ],
    "class": "net.opentsdb.tsd.HttpJsonSerializer",
    "response_content_type": "application/json; charset=UTF-8",
    "request_content_type": "application/json"
  }
]

© 2010–2016 The OpenTSDB Authors
Licensed under the GNU LGPLv2.1+ and GPLv3+ licenses.
http://opentsdb.net/docs/build/html/api_http/serializers.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API