Створення / редагування тегів

Для роботи з цим методом користувач повинен бути авторизованим .

Метод запиту

HTTP POST

Content-Type

text/json; charset=UTF-8 (тіло запиту/відповіді в json форматі в тілі HTTP запиту)

URL запиту

https://doc.edin.ua/bdoc/tag

Параметри, що передаються в URL (разом з адресою методу)

В рядку заголовка (Header) «Set-Cookie» обов’язково передається SID - токен, отриманий при авторизації

Важливо

Редагування тегу відбувається аналогічним запитом за допомогою перезапису даних, обов’язково при цьому вказувати tagId!

JSON-параметри в тілі HTTP запиту/відповіді

REQUEST

Таблиця 1 - Опис json-параметрів запиту метода API

Параметр

Mandatory/Optional

Формат

Опис

name

M

String

назва тегу

code

О

long

унікальний код, якщо не передано створиться автоматично

RESPONSE

У відповідь передаються дані тегу (об’єкт Tag).

Таблиця 2 - Опис параметрів об’єкта Tag

Параметр

Формат

Опис

Об’єкт Tag

tagId

long

ID тега

name

String

назва тега

code

long

унікальний код ідентифікатор

accountId

long

ID аккаунту

Приклади

Приклад тіла запиту в json форматі

{
  "code": "6418c44baec34df7bc17a66a1989fa1a",
  "name": "Альбатрос"
}

Приклад тіла відповіді в json форматі

{
  "tagId": 409,
  "name": "Альбатрос",
  "code": "6418c44baec34df7bc17a66a1989fa1a"
}