Справочник API
Статусы
Создание статусов

Базовый URL

POST
https://v1.empr.cloud/api/v1/folders/{folderId}/statuses

Запрос

Заголовки запроса

Заголовки
Название
Тип / Значение
Описание
X-Token
String
Токен аутентификации
Content-Type
application/json

Параметры URL

Параметры запроса
Название
Тип / Значение
Описание
folderId
UUID
Идентификатор папки

Тело запроса

Тело
Название
Тип / Значение
Описание
statuses
[[Name, Color]]
Массив статусов

Примеры запроса

1const url =
2  "https://v1.empr.cloud/api/v1/folders/{folderId}/proxies"; 
3
4const body = {
5  "statuses": [
6    [
7      "Хорошо",
8      "#00AB55"
9    ]
10  ]
11}
12
13const options = {
14  method: "POST",
15  headers: {
16    "X-Token": "Your Token", 
17    "Content-Type": "application/json"
18  }, 
19  body: JSON.stringify(body)
20};
21
22fetch(url, options)
23  .then((response) => {
24    response.json().then((data) => {
25      console.log(data);
26    });
27  })
28  .catch((error) => {
29    console.error(error);
30  });

Ответ

Данные ответа

Ответ
Название
Тип / Значение
Описание
data
Array<Status>
Массив созданных статусов

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

1{
2    "data": [
3        {
4            "user_id": "***privacy***",
5            "id": "***privacy***",
6            "folder_id": "***privacy***",
7            "status": "Хорошо",
8            "status_color": "#00AB55",
9            "created_at": "2024-01-06T15:32:32.679444Z",
10            "updated_at": "2024-01-06T15:32:32.679444Z"
11        }
12    ]
13}

Типы

Status
Название
Тип / Значение
Описание
id
String
ID
user_id
String
ID владельца
status
String
Статус
status_color
String
Шестнадцатеричная строка, представляющая цвет статуса
created_at
String
Дата создания
updated_at
String
Дата последнего обновления