Створення / редагування тегів¶
Для роботи з цим методом користувач повинен бути авторизованим .
Метод запиту |
HTTP POST |
---|---|
Content-Type |
text/json; charset=UTF-8 (тіло запиту/відповіді в json форматі в тілі HTTP запиту) |
URL запиту |
|
Параметри, що передаються в 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"
}