Поддержка
Чат для вопросов по API
Мгновенно ответим на ваши вопросы
api@ati.su
Электронная почта техподдержки
Тикетная система
Оставить заявку на отдел
«Консультанты по интеграции (API)»
api.ati.su - заказы, торги, площадки
Наш телеграм-канал
Код в ATI.SU:
Выход
Для подтверждения действия введите пароль
Чтобы продолжить, введите пароль для пользователя

API для работы с файлами, логотипами и аватарками (В доработке)

В данном разделе вы можете найти методы для работы с файлами, логотипами и аватарками фирм и контактов

Максимальный разрешенный размер - 10 Мб Поддерживаемые форматы: .bmp, .doc, .docx, .gif, .jpeg, .jpg, .odt, .pdf, .png, .pps, .ppsx, .ppt, .pptx, .rar, .rtf, .tif, .tiff, .txt, .xls, .xlsx, .xml, .cer, .crt, .pem, .wmv, .mdi

Возможности сервиса

Методы для работы с аватарками/логотипам

Загрузка логотипа фирмы или аватарки контакта

Загружает логотип фирмы или аватарку контакта

 
Загружает логотип фирмы или аватарку контакта
post
/avatars/
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200
Развернуть все Свернуть все
Пример Модель
{...}
"ok":false,
"url":"string",
"name":"string"
}
{...}
ok: boolean

Идентификатор успешности запроса

url: string

Ссылка на сохраненный аватар

name: string

Имя сохраненной аватарки

}
401 Ошибка авторизации
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление логотипа фирмы или аватарки контакта

Удаляет логотип фирмы или аватарку контакт

 
Удаляет логотип фирмы или аватарку контакта
delete
/avatars/
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Логотип/аватарка удалена
Развернуть все Свернуть все
401 Ошибка авторизации
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

Загрузка логотипа фирмы

Загружает логотип фирмы

Загружает логотип фирмы
post
/avatars/logo
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200
Развернуть все Свернуть все
Пример Модель
{...}
"ok":false,
"url":"string",
"name":"string"
}
{...}
ok: boolean

Идентификатор успешности запроса

url: string

Ссылка на сохраненный аватар

name: string

Имя сохраненной аватарки

}
401 Ошибка авторизации
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление логотипа фирмы

Удаляет логотип фирмы

 
Удаляет логотип фирмы или аватарку контакта
delete
/avatars/
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Логотип/аватарка удалена
Развернуть все Свернуть все
401 Ошибка авторизации
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

Методы для работы с файлами

Загрузка файла

Сохраняет файл на файловую систему

Описание тела запроса

{
  "firms": {
    "type": "string",
    "description": "Список фирм, имеющих доступ к этому документу"
  },
  "rawBody": {
    "type": "string",
    "format": "binary",
    "description": "Тело файла"
  }
}
 
Загрузить файл в хранилище
post
/v1.0/filestorage/files/
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Информация о файле - id
Развернуть все Свернуть все
Пример Модель
{...}
"ok":false,
"result":{...}
"id":"string",
"fileName":"string",
"size":0,
"mimetype":"string",
"link":"string"
}
}
{...}
ok: boolean

Идентификатор успешности запроса

}
400 Отсутствует файл в поле rawBody, или Отправлен пустой файл
Развернуть все Свернуть все
401 Ошибка авторизации
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

Загрузка нескольких файлов

Метод позволяет загрузить сразу несколько файлов на файловую систему.

Описание тела запроса

{
  "firms": {
    "type": "string",
    "description": "Список фирм, имеющих доступ к этому документу"
  },
  "rawBody": {
    "type": "array",
    "items": {
      "type": "string",
      "format": "binary",
      "description": "Список из тел файла"
    }
  }
}

Если файл загрузить не удалось, то для него возвращается схема

{
  "error": {
    "type": "string",
    "title": "Идентификатор ошибки"
  },
  "reason": {
    "type": "string",
    "title": "Текст ошибки"
  },
  "id": {
    "type": "string",
    "title": "Идентификатор файла"
  }
}
 
Загрузить несколько файлов в хранилище
post
/v1.0/filestorage/files/multiple
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Список с информацией о созданных файлах и ошибках
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"ok":false,
"result":{...}
"id":"string",
"fileName":"string",
"size":0,
"mimetype":"string",
"link":"string"
}
}
]
[{...}]
ok: boolean
}]
400 Отсутствует или пустое поле rawBody
Развернуть все Свернуть все
401 Ошибка авторизации
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление файла

Метод удаляет загруженный файл

 
Удалить файл
delete
/v1.0/filestorage/files/{file_id}/
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Подверждение об удалении файла
Развернуть все Свернуть все
400 Файл не найден
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

Удаление нескольких файлов

Метод позволяет удалить сразу несколько загруженных файлов.

Если файл удалить не удалось, то для него возвращается схема

{
  "error": {
    "type": "string",
    "title": "Идентификатор ошибки"
  },
  "reason": {
    "type": "string",
    "title": "Текст ошибки"
  },
  "id": {
    "type": "string",
    "title": "Идентификатор файла"
  }
}
 
Удалить несколько файлов из хранилища
delete
/v1.0/filestorage/files/multiple
Развернуть все Свернуть все
[string]

Идентификатор файла

CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Список с информацией о созданных файлах и ошибках
Развернуть все Свернуть все
Пример Модель
[...]
{...}
"ok":false,
"id":"string"
}
]
[{...}]
ok: boolean
id: string
}]
400 Отсутствует или пустое поле rawBody
Развернуть все Свернуть все
401 Ошибка авторизации
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...

Получение файла по его ID

Возвращает файл по его file_id

 
Получить файл по его ID
get
/v1.0/filestorage/files/{file_id}/
CURL 1C
CURL
Копировать

                
1C
Копировать

                
Пример ответа Ответ
200 Содержимое файла
Развернуть все Свернуть все
400 Файл не найден
Развернуть все Свернуть все
Загрузка...
Развернуть все Свернуть все
Загрузка...