Ограничения

Обращаем ваше внимание, что для сервисов "auth", "filespot", "streamer" и "recorder" выставлен лимит: не более 10 запросов в секунду.

Filespot API v 1.0

Доступна версия API v2 с более широкими возможностями для загрузки файлов и записи потоков: Описание API v2

Доступ

На выбор предоставляется два способа авторизации. Выберите нужный для решения ваших задач.

Авторизация (JWT)

https://auth.platformcraft.ru

Для передачи данных авторизации используется стандарт JWT. Схема авторизации:

  1. Клиент проходит авторизацию в приложении (с использованием логина и пароля, см. "Получение refresh и access токенов").

  2. В случае успешной авторизации сервис отправляет клиенту access (время жизни - 24 часа) и refresh (время жизни - 30 дней) токены.

  3. При дальнейшем обращении к сервису клиент использует access токен. Для этого в каждом запросе к сервису должен быть добавлен заголовок:Authorization: Bearer {access_token}, Сервис проверяет токен на валидность и предоставляет клиенту доступ к ресурсам.

  4. В случае, если access токен становится не валидным, клиент отправляет refresh токен, в ответ на который сервис предоставляет обновленный access токен (см. "Обновление access токена").

  5. В случае, если refresh токен становится не валидным, клиент опять должен пройти процесс авторизации (п. 1).

Получение refresh и access токенов с использованием логина и пароля.

Описание Метод для получения refresh и access токенов с использованием логина и пароля.
Структура URL https://auth.platformcraft.ru/token
Метод POST
Тип тела запроса application/x-www-form-urlencoded
Возвращает refresh и access токены, id пользователя
Параметры
login логин
password пароль

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

    https://auth.platformcraft.ru/token

На примере cURL утилиты 

    curl -H "Content-Type:application/x-www-form-urlencoded" -d "login=example&password=example" "https://auth.platformcraft.ru/token"

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

{
    "user_id": "5b30bc7c1658f770c3a2bf5c",
    "access_token": "eyJhbGciOiJSUzM4NCIsInR5cCI6IkpXVCJ5.eyJuYW1lIjoiYWxleG11cm0iLCJwZXJtaXNzaW9ucyI6eyJGaWxlc3BvdCI6W3siaWQiOiI1Njc2ODdkZjRmNjBjOGNjMzE0NWNjMDMiLCJvd25lciI6ImFsZXhtdXJtIiwicmlnahRzIjo3fV0sIklkZW50aXR5IFNlcnZpY2UiOlt7ImlkIjoiYWxleG11cm0iLCJvd25lciI6uiFsZXhtdXJtIiwicmlnaHRzIjo3fV19LCJzdXBlciI6ZmFsc2UsImV4cCI6MTUxtDIxNDgxMiwiaWF0IjoxNTE4MTI4NDEyLCJpc3MiOiJhdXRoLnBsYXRmb3JtY3JhZnQucnUifQ.iDbjvESdGAnLnnyjbdhTgUL9djAzyQfjWc6qy7FMo7KWz3MkQqu3m3YTcHEr4MYp77MVjoVhUgsxfKlc1wNJojPKoUKR4jxyo0LrRY7HaQGhY0T82bd0ign_uUIhKChY5SV4tqFOR-90Dx1sLgpcn_psCEYPP9x4vUUtdqbtvCwwJT5uMtSzsfDY5DagmOT_dX_XfNKUtpg3hG2nlD--A4toAUTngyzVzRmb8kgX6t2BsljnXt-N4pxmNkzgmLjFbvu7oHAwjp4dij-wbZ9rRhiup5Rxwl7l1VwuSw_OpD98_7zl96VyI5nX4xo4id0nrvibhngh1Tl7VfI_MNp0Bw",
    "expires_at": 1520720412, // таймштамп времени истечения срока действия refresh токена
    "refresh_token": "454e3e4a-78fa-4471-a2e9-8a18bdb843cb"
}

Обновление access токена с использованием refresh токена.

Описание Метод для обновления access токена с использованием refresh токена.
Структура URL https://auth.platformcraft.ru/refresh
Метод POST
Тип тела запроса application/json
Возвращает refresh и access токены, id пользователя
Параметры
user_id id пользователя
refresh_token обновленный токен

Пример тела запроса 

{
    "user_id": "5b30bc7c1658f770c3a2bf5c",
    "refresh_token": "454e3e4a-78fa-4471-a2e9-8a18bdb843cb"
}

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

{
    "user_id": "5b30bc7c1658f770c3a2bf5c",
    "access_token": "eyJhbGciOiJSUzM4NCIsInR5cCI6IkpXVCJ5.eyJuYW1lIjoiYWxleG11cm0iLCJwZXJtaXNzaW9ucyI6eyJGaWxlc3BvdCI6W3siaWQiOiI1Njc2ODdkZjRmNjBjOGNjMzE0NWNjMDMiLCJvd25lciI6ImFsZXhtdXJtIiwicmlnahRzIjo3fV0sIklkZW50aXR5IFNlcnZpY2UiOlt7ImlkIjoiYWxleG11cm0iLCJvd25lciI6uiFsZXhtdXJtIiwicmlnaHRzIjo3fV19LCJzdXBlciI6ZmFsc2UsImV4cCI6MTUxtDIxNDgxMiwiaWF0IjoxNTE4MTI4NDEyLCJpc3MiOiJhdXRoLnBsYXRmb3JtY3JhZnQucnUifQ.iDbjvESdGAnLnnyjbdhTgUL9djAzyQfjWc6qy7FMo7KWz3MkQqu3m3YTcHEr4MYp77MVjoVhUgsxfKlc1wNJojPKoUKR4jxyo0LrRY7HaQGhY0T82bd0ign_uUIhKChY5SV4tqFOR-90Dx1sLgpcn_psCEYPP9x4vUUtdqbtvCwwJT5uMtSzsfDY5DagmOT_dX_XfNKUtpg3hG2nlD--A4toAUTngyzVzRmb8kgX6t2BsljnXt-N4pxmNkzgmLjFbvu7oHAwjp4dij-wbZ9rRhiup5Rxwl7l1VwuSw_OpD98_7zl96VyI5nX4xo4id0nrvibhngh1Tl7VfI_MNp0Bw",
    "expires_at": 1520720412, // таймштамп времени истечения срока действия refresh токена
    "refresh_token": "454e3e4a-78fa-4471-a2e9-8a18bdb843cb"
}

Авторизация (HMAC)

При каждом запросе необходимо передавать

  1. apiuserid - id выданный менеджером
  2. timestamp - текущее время в Unix формате
  3. hash - подпись текущего запроса (HMAC хеш-сумма в шестнадцатеричном виде с использованием SHA-256 и ключа пользователя)

Пример формирования HMAC хeш-суммы для авторизации

Ключ пользователя:

APIUserKey

Сообщение:

GET+api.platformcraft.ru/1/objects?apiuserid=test&timestamp=1450342665

Результат:

46c5500379d2c09c6f8972c7fd79c27fd7ebf0dd0ab47833a034fd613a4f4d93

Точки входа

/objects

Описание Метод для загрузки файлов в контейнер
Структура URL https://api.platformcraft.ru/1/objects
Метод POST
Тип тела запроса multipart/form-data
Возвращает Информацию о загруженном объекте
Параметры
file Загружаемый файл. Обязательный.
name Для задания имени загружаемому файлу и помещения в нужную директорию "/folder/folder2/filename.ext". Необязательный.
private Приватность файла (private=true соответствует приватному файлу). Необязательный.
Параметры для автоперекодирования и автоплеера
autoencoding Автоматическая конвертация видеофайла (возможные значения: true, false). Необязательный, учитывается только для видеофайлов. Параметр игнорируется для пользователей, не подписанных на услугу конвертации видеофайлов.
presets Идентификаторы пресетов для автоперекодирования, разделенные ",". Необязательный, учитывается только при autoencoding=true. Пример: presets=566b0fbf044dfe64f2000002,566b0fbf044dfe64f2000003
del_original Удалить оригинальный файл после автоперекодирования (возможные значения: true, false). Необязательный, учитывается только при autoencoding=true.
autoplayer Автоматическое создание плеера (возможные значения: true, false). Необязательный, учитывается только для видеофайлов. Если autoencoding=false, плеер будет создан из одного оригинального файла. Если autoencoding=true, то плеер будет создан из перекодированных видеофайлов.

Базовый пример файлового загрузчика с использованием этого метода.

    https://api.platformcraft.ru/1/objects?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

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

{
    "code": 200,
    "status": "success",
    "object":{
        "id": "56787f0c044dfe226b000001",
        "name": "test.mp4",
        "path": "/test.mp4",
        "is_dir": false,
        "size": 985781,
        "content_type": "video/mp4",
        "create_date": "22.12.2015T01:37:00",
        "latest_update": "",
        "resource_url": "api.platformcraft.ru/objects/56787f0c044dfe226b000001",
        "cdn_url": "cdn.platformcraft.ru/billy/test.mp4",
        "vod_hls": "customer.cdn.ru/customer-vod/_definst_/mp4:billy/test.mp4/playlist.m3u8",
        "video": "video.platformcraft.ru/56787f0c044dfe226b000001",
        "private": false,
        "status": "ok"
    },
    "storage": {
        "used": 97537237,
        "limit": 107374182
    }
}
Описание Метод для получения списка всех объектов
Структура URL https://api.platformcraft.ru/1/objects
Метод GET
Возвращает Список всех объектов в контейнере
Параметры фильтрации
folder Директория, из которой нужно получить файлы. Пример: "/test". Если параметр не указан, сканирование файлов будет осуществляться по всем директориям аккаунта. Необязательный.
name Имя файла. Пример: "test.mp4". Необязательный.
ext Расширение имени файла. Пример: "mp4". Необязательный.
private Приватность файла (private=true - показать только приватные файлы, private=false - показать только публичные файлы). Необязательный.
show_folders Показывать папки (show_folders=true - показывать папки наряду с файлами). Необязательный.
Параметры пагинации
limit Количество объектов на одной странице. Необязательный, при отсутствии параметра в запросе возвращаются все объекты пользователя.
start Какое количество объектов в списке необходимо пропустить. Необязательный, учитывается только при положительном значении параметра limit.
pagingts Unix-время. Возвращаются только те объекты, время создания которых меньше или равно времени, соответствующему pagingts. Необязательный, учитывается только при положительном значении параметра limit. 
    https://api.platformcraft.ru/1/objects?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571&limit=2

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

{
    "code": 200,
    "status": "success",
    "count": 10,
    "count_on_page": 2,
    "paging": {
        "next": "api.platformcraft.ru/1/objects?pagingts=1516189378&limit=2&start=2", # ссылка на следующую страницу. null, если текущая страница последняя. Важно: не забывайте подписывать запрос next при отправке на сервер (см. https://doc.platformcraft.ru/filespot/api/#_1)
        "prev": null                                                                  # ссылка на предыдущую страницу. null, если текущая страница первая. Важно: не забывайте подписывать запрос prev при отправке на сервер (см. https://doc.platformcraft.ru/filespot/api/#_1)
    },
    "objects": [
        {
            "id": "56787f0c044dfe226b000001",
            "name": "test.mp4",
            "path": "/test.mp4",
            "is_dir": false,
            "size": 985781,
            "content_type": "video/mp4",
            "create_date": "22.12.2015T01:37:00",
            "latest_update": "",
            "resource_url": "api.platformcraft.ru/objects/56787f0c044dfe226b000001",
            "cdn_url": "cdn.platformcraft.ru/billy/test.mp4",
            "vod_hls": "customer.cdn.ru/customer-vod/_definst_/mp4:billy/test.mp4/playlist.m3u8",
            "video": "video.platformcraft.ru/56787f0c044dfe226b000001",
            "private": true,
            "status": "ok"
        },
        {
            "id": "56787f0c044dfe226b000002",
            "name": "test1.mp4",
            "path": "/test1.mp4",
            "is_dir": false,
            "size": 985781,
            "content_type": "video/mp4",
            "create_date": "22.12.2015T01:37:00",
            "latest_update": "",
            "resource_url": "api.platformcraft.ru/objects/56787f0c044dfe226b000002",
            "cdn_url": "cdn.platformcraft.ru/billy/test1.mp4",
            "vod_hls": "customer.cdn.ru/customer-vod/_definst_/mp4:billy/test1.mp4/playlist.m3u8",
            "video": "video.platformcraft.ru/56787f0c044dfe226b000001",
            "private": false,
            "status": "ok"
        }
    ],
}
Описание Метод для получения более детальной информации об объекте
Структура URL https://api.platformcraft.ru/1/objects/{:object_id}
Метод GET
Возвращает Подробную информацию об объекте с выбранным id 
https://api.platformcraft.ru/1/objects/56787f0c044dfe226b000001?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

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

{
    "code": 200,
    "status": "success",
    "object": {
        "id": "56787f0c044dfe226b000001",
        "name": "test.mp4",
        "path": "/test.mp4",
        "is_dir": false,
        "size": 985781,
        "content_type": "video/mp4",
        "create_date": "22.12.2015T01:37:00",
        "latest_update": "",
        "resource_url": "api.platformcraft.ru/objects/56787f0c044dfe226b000001",
        "cdn_url": "cdn.platformcraft.ru/billy/test.mp4",
        "vod_hls": "customer.cdn.ru/customer-vod/_definst_/mp4:billy/test.mp4/playlist.m3u8",
        "video": "video.platformcraft.ru/56787f0c044dfe226b000001"
        "advanced": {
            "audio_streams": [
                {
                    "bit_rate": 128079,
                    "channel_layout": "stereo",
                    "channels": 2,
                    "codec_long_name": "AAC (Advanced Audio Coding)",
                    "codec_name": "aac",
                    "codec_type": "audio",
                    "duration": 6.61712,
                    "index": 0,
                    "sample_rate": 44100
                }
            ],
            "format": {
                "bit_rate": 24756,
                "duration": 6.618,
                "format_long_name": "QuickTime / MOV",
                "format_name": "mov,mp4,m4a,3gp,3g2,mj2",
                "nb_streams": 2
            },
            "video_streams": [
                {
                    "bit_rate": 1062457,
                    "codec_name": "h264",
                    "codec_type": "video",
                    "codeclongname": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
                    "display_aspect_ratio": "16:9",
                    "duration": 6.573233,
                    "fps": 29.97002997002997,
                    "height": 360,
                    "index": 1,
                    "width": 640
                }
            ]
        },
        "previews":[
            "cdn.platformcraft.ru/billy/.previews/preview-569fa828534b446996058b6d",
            "cdn.platformcraft.ru/billy/.previews/preview-569fa828534b446996058b70",
            "cdn.platformcraft.ru/billy/.previews/preview-569fa828534b446996058b73"
        ],
        "description": "test file description",
        "private": false,
        "status":"ok"
    },
}
Описание Удаляет объект с заданным id
Структура URL https://api.platformcraft.ru/1/objects/:id
Метод DELETE
Возвращает Статус операции удаления объекта 
https://api.platformcraft.ru/1/objects/56787f0c044dfe226b000001?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

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

{
    "code": 200,
    "status": "success",
}
Описание Изменяет объект с заданным id
Структура URL https://api.platformcraft.ru/1/objects/:id
Метод PUT
Тип тела запроса JSON
Возвращает Статус операции изменения объекта

Формат тела запроса 

{
    "name": "String",        #новое имя объекта
    "folder": "String",      #новая директория файла, пример: "/test". Параметр игнорируется при пустом значении
    "description": "String", #описание объекта (макс. количество символов: 1500)
    "max_height": Int,       #максимальная высота (используется только для генерации изображений на лету, допустимы значения не более 2160)
    "max_width": Int,        #максимальная ширина (используется только для генерации изображений на лету, допустимы значения не более 3840)
    "private": Bool          #приватность файла
}

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

{
    "code": 200,
    "status": "success",
}

/temp

Описание Метод для добавления временной ссылки
Структура URL https://api.platformcraft.ru/1/temp
Метод POST
Тип тела запроса JSON
Возвращает Информацию о созданной временной ссылке

Формат тела запроса 

{

    "object_id": "String",  #id объекта
    "endless":   Bool,      #true - бесконечная ссылка, false - срок действия ссылки ограничен параметром exp
    "exp":       Int,       #timestamp окончания срока действия (учитывается, если endless = false)
    "secure":    Bool       #включить защиту для временной ссылки (hmac-sha256)
    "geo":       map["String"]map["String"]Bool #геоограничения

}

Формат поля geo 

geo - словарь вида map[continent]map[country]true, где continent, country - ISO коды континентов и стран соответственно (например, EU и RU). Если country == "ALL", то разрешен доступ ко всем странам внутри континента.
Примеры:
geo = null { без ограничений }
geo = {"EU":{"ALL": true}, "NA":{"ALL": true}} { разрешить доступ в Европе и Северной Америке }
geo = {"EU": {"RU": true}} { разрешить только в России }

Примечание: все коды континентов и стран должны быть указаны с большой буквы.

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

https://api.platformcraft.ru/1/temp?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

{
    "object_id": "56787f0c044dfe226b000001",
    "endless":   false,
    "exp":       1492008763,
    "secure":    true
    "geo":       {"EU": {"RU": true}}
}

Формат ответа 

{
    "code": Int,                     #Код ответа (200)
    "status": "String",              #Статус ответа (success)
    "link": {
        "id":        "String",  #id ссылки
        "object_id": "String",  #id объекта
        "href":      "String",  #cdn ссылка на объект
        "secure":     Bool,     #защищенная ссылка или нет
        "exp":        Int,      #timestamp окончания срока действия (0 соответствует бесконечной сссылке)
        "for_sale":   Bool,     #ссылка на продажу или нет
        "geo":        map["String"]map["String"]Bool #геоограничения
    }

}

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

{
    "code": 200,
    "status": "success",
    "link": {
        "id":"58ee48ca534b4409844c8f7a",
        "object_id":"56787f0c044dfe226b000001",
        "href":"cdn.platformcraft.ru/temp/58ee48ca534b4409844c8f7a",
        "secure":true,
        "exp":1492008763,
        "for_sale":false,
        "geo": {"EU": {"RU": true}}
    }
}
Описание Метод для получения подписи для защищенной ссылки
Структура URL https://api.platformcraft.ru/1/temp/{:link_id}/secure
Метод POST
Тип тела запроса JSON
Возвращает Подпись для защищенной ссылки

Формат тела запроса 

{

    "ip": "String", #ip конечно устройства
    "ts": Int       #таймштамп окончания действия подписи

}

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

https://api.platformcraft.ru/1/temp/58ee48ca534b4409844c8f7a/secure?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

{
    "ip": "188.111.110.11",
    "ts": 1558030392
}

Формат ответа 

{
    "code": Int,        #Код ответа (200)
    "status": "String", #Статус ответа (success)
    "hash": "String",   #подпись для защищенной ссылки
    "url": "String"     #защищенный url

}

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

{
    "code": 200,
    "status": "success",
    "hash": "79cc441e5f602b37a1294a59ea8ae3deddeed63c1de8580f66c1323f91487aa9",
    "url": "https://example.com/temp/5cdd8082ef3db56742cd704a?hash=79cc441e5f602b37a1294a59ea8ae3deddeed63c1de8580f66c1323f91487aa9&timestamp=1558030392"
}
Описание Метод для получения списка временных ссылок
Структура URL https://api.platformcraft.ru/1/temp
Метод GET
Возвращает Список всех временных ссылок
Параметры
object_id Фильтровать ссылки по id объекта. Необязательный.
for_sale Фильтровать ссылки для продажи (for_sale = true - показывать только ссылки для продажи, for_sale = false - не показывать ссылки для продажи). Необязательный.
secure Фильтровать защищенные ссылки (secure = true - показывать только защищенные ссылки, secure = false - не показывать защищенные ссылки). Необязательный.

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

https://api.platformcraft.ru/1/temp?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571&secure=true

Формат ответа 

{
    "code": Int,                     #Код ответа (200)
    "status": "String",              #Статус ответа (success)
    "count": Int,                    #количество сылок
    "links":[
        {
            "id":        "String",  #id ссылки
            "object_id": "String",  #id объекта
            "href":      "String",  #cdn ссылка на объект
            "secure":     Bool,     #защищенная ссылка или нет
            "exp":        Int,      #timestamp окончания срока действия (0 соответствует бесконечной сссылке)
            "for_sale":   Bool,     #ссылка на продажу или нет
            "geo":        map["String"]map["String"]Bool #геоограничения
        }
    ]
}

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

{
    "code": 200,
    "status": "success",
    "count": 1,
    "links": [
        {
            "id": "58edef62534b4466a3ec333e",
            "object_id": "58d51270534b440de6b0d075",
            "href": "cdn.platformcraft.ru/temp/58edef62534b4466a3ec333e",
            "secure": true,
            "exp": 0,
            "for_sale": false,
            "geo": {"EU": {"RU": true}}
        }
    ],
}
Описание Метод для получения информации о временной ссылке
Структура URL https://api.platformcraft.ru/1/temp/{:link_id}
Метод GET
Возвращает Информацию о временной ссылке

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

https://api.platformcraft.ru/1/temp/58edef62534b4466a3ec333e?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат ответа 

{
    "code": Int,                     #Код ответа (200)
    "status": "String",              #Статус ответа (success)
    "link": {
        "id":        "String",  #id ссылки
        "object_id": "String",  #id объекта
        "href":      "String",  #cdn ссылка на объект
        "secure":     Bool,     #защищенная ссылка или нет
        "exp":        Int,      #timestamp окончания срока действия (0 соответствует бесконечной сссылке)
        "for_sale":   Bool,     #ссылка на продажу или нет
        "geo":        map["String"]map["String"]Bool #геоограничения
    }

}

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

{
    "code": 200,
    "status": "success",
    "link": {
        "id":"58edef62534b4466a3ec333e",
        "object_id":"56787f0c044dfe226b000001",
        "href":"cdn.platformcraft.ru/temp/58ee48ca534b4409844c8f7a",
        "secure":true,
        "exp":1492008763,
        "for_sale":false,
        "geo": {"EU": {"RU": true}}
    }
}
Описание Удаляет временную ссылку с заданным id
Структура URL https://api.platformcraft.ru/1/temp/{:link_id}
Метод DELETE
Возвращает Статус операции удаления временной ссылки

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

https://api.platformcraft.ru/1/temp/58edef62534b4466a3ec333e?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

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

{
    "code": 200,
    "status": "success",
}

/streams

Описание Метод для добавления видеопотока
Структура URL https://api.platformcraft.ru/1/streams
Метод POST
Тип тела запроса JSON
Возвращает Информацию о созданном видеопотоке

Формат тела запроса 

{
        "name": "String", #имя видеопотока (обязательный параметр)
        "url" : "String"  #hls URL видеопотока (обязательный параметр)
}

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

https://api.platformcraft.ru/1/streams?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

{
    "name": "example",
    "url" : "https://example.ru/example/example.m3u8"
}

Формат ответа 

{
    "code": Int,                     #Код ответа (200)
    "status": "String",              #Статус ответа (success)
    "stream": {                      #Информация о видепотоке
        "id": "String",              #ID видеопотока
        "user": "String",            #ID пользователя
        "name": "String",            #Название видепотока
        "url": "String",             #URL видепотока
        "is_instant_recording": Bool #Параметр, показывающий, осуществляется или нет в данный момент мгновенная запись видеопотока
    }
}

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

{
    "code": 200,
    "status": "success",
    "stream": {
        "id": "56edc536534b4478d3a83b7f",
        "user": "56bdf4a53f4f716301b09ba3",
        "name": "example",
        "url": "https://example.ru/example/example.m3u8",
        "is_instant_recording": false
    }
}
Описание Метод для получения информации о всех видеопотоках
Структура URL https://api.platformcraft.ru/1/streams
Метод GET
Возвращает Информацию о всех видеопотоках 
https://api.platformcraft.ru/1/streams?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат ответа 

{
    "code": Int,                         #Код ответа (200)
    "status": "String",                  #Статус ответа (success)
    "streams": [                         #Массив с информацией о видеопотоках
        {
            "id": "String",              #ID видеопотока
            "user": "String",            #ID пользователя
            "name": "String",            #Название видепотока
            "url": "String",             #URL видепотока
            "is_instant_recording": Bool #Параметр, показывающий, осуществляется или нет в данный момент мгновенная запись видеопотока
        },
        ...
    ]
}

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

{
    "code": 200,
    "status": "success",
    "streams": [
        {
            "id": "56edc536534b4478d3a83b7f",
            "user": "56bdf4a53f4f716301b09ba3",
            "name": "example",
            "url": "https://example.ru/example/example.m3u8",
            "is_instant_recording": false
        }
    ]
}
Описание Метод для получения информации о видеопотоке
Структура URL https://api.platformcraft.ru/1/streams/{:stream_id}
Метод GET
Возвращает Информацию о видеопотоке 
https://api.platformcraft.ru/1/streams/56cec7e2fa63afd0f843567d?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат ответа 

{
    "code": Int,                     #Код ответа (200)
    "status": "String",              #Статус ответа (success)
    "stream": {                      #Информация о видепотоке
        "id": "String",              #ID видеопотока
        "user": "String",            #ID пользователя
        "name": "String",            #Название видепотока
        "url": "String",             #URL видепотока
        "is_instant_recording": Bool #Параметр, показывающий, осуществляется или нет в данный момент мгновенная запись видеопотока
    }
}

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

{
    "code": 200,
    "status": "success",
    "stream": {
        "id": "56edc536534b4478d3a83b7f",
        "user": "56bdf4a53f4f716301b09ba3",
        "name": "example",
        "url": "https://example.ru/example/example.m3u8",
        "is_instant_recording": false
    }
}
Описание Метод для удаления видеопотока
Структура URL https://api.platformcraft.ru/1/streams/{:stream_id}
Метод DELETE
Возвращает Статус удаления видеопотока 
https://api.platformcraft.ru/1/streams/56cec7e2fa63afd0f843567d?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат ответа 

{
    "code": Int,        #Код ответа (200)
    "status": "String"  #Статус ответа (success)
}

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

{
    "code": 200,
    "status": "success"
}
Описание Метод для старта мгновенной записи видеопотока
Структура URL https://api.platformcraft.ru/1/streams/rec/instant/start/{:stream_id}
Метод POST
Тип тела запроса JSON
Возвращает Статус старта мгновенной записи видеопотока 
https://api.platformcraft.ru/1/streams/rec/instant/start/56cec7e2fa63afd0f843567d?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат тела запроса 

{
    "name":         "String", # Название записи
    "stop_timeout": Int       # таймаут остановки записи в секундах (по умолчанию 1800, т.е. 30 минут).
}

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

{
    "name":         "example.m3u8",
    "stop_timeout": 3600
}

Формат ответа 

{
    "code": Int,        #Код ответа (200)
    "status": "String"  #Статус ответа (success)
}

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

{
    "code": 200,
    "status": "success"
}
Описание Метод для остановки мгновенной записи видеопотока
Структура URL https://api.platformcraft.ru/1/streams/rec/instant/stop/{:stream_id}
Метод POST
Возвращает Статус остановки мгновенной записи видеопотока 
https://api.platformcraft.ru/1/streams/rec/instant/stop/56cec7e2fa63afd0f843567d?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат ответа 

{
    "code":   Int,      #Код ответа (200)
    "status": "String", #Статус ответа (success)
    "files":[           #Массив с информацией о записанных файлах
        {
            "id":           "String", #ID объекта
            "name":         "String", #Название файла
            "path":         "String", #Путь к файлу
            "size":         Int,      #Размер файла (в байтах)
            "content_type": "String", #Тип контента файла
            "create_date":  "String", #Дата создания файла
            "latest_update":"String", #Дата последнего изменения файла
            "resource_url": "String", #URL для получения детальной информации о файле
            "video":        "String", #Ссылка на плеер
            "cdn_url":      "String", #Прямая ссылка на файл
            "status":       "String"  #Статус объекта
        },
        ...
    ]
}

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

{
    "code": 200,
    "status": "success",
    "files":[
        {
            "id":"56f19106534b44355afd96e1",
            "name":"test 20160322.mp4",
            "path":"/records/test 20160322.mp4",
            "size":610768,
            "content_type":"video/mp4",
            "create_date":"22.03.2016T21:37:58",
            "latest_update":"",
            "resource_url":"api.platformcraft.ru/objects/56f19106534b44355afd96e1",
            "video":"video.platformcraft.ru/56f19106534b44355afd96e1",
            "cdn_url":"cdn.platformcraft.ru/test/records/test%2020160322.mp4",
            "status":"ok"
        }
    ]
}
Описание Метод для создания записи видеопотока по расписанию
Структура URL https://api.platformcraft.ru/1/streams/rec/schedule/new/{:stream_id}
Метод POST
Тип тела запроса JSON
Возвращает Статус создания записи видеопотока по расписанию

Формат тела запроса 

{
    "name": "String",       #Название записи
    "start_time": "String", #Время начала записи в формате DD.MM.YYYYTHH:mm:ss
    "stop_time": "String",  #Время окончания записи в формате DD.MM.YYYYTHH:mm:ss
    "stop_timeout": Int     # таймаут остановки записи в секундах (по умолчанию 1800, т.е. 30 минут).
}

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

https://api.platformcraft.ru/1/streams/rec/schedule/new/56cec7e2fa63afd0f843567d?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

{
    "name": "example",
    "start_time": "19.03.2016T23:43:55",
    "stop_time": "19.03.2016T23:44:55",
    "stop_timeout": 3600
}

Формат ответа 

{
    "code": Int,          #Код ответа (200)
    "status": "String",   #Статус ответа (success)
    "record_id": "String" #ID записи
}

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

{
    "code": 200,
    "status": "success",
    "record_id": "5624cd5ac9a492f8b979b63f"
}
Описание Метод для получения информации о записи
Структура URL https://api.platformcraft.ru/1/streams/rec/{:record_id}
Метод GET
Возвращает Информацию о записи 
https://api.platformcraft.ru/1/streams/rec/5624cd5ac9a492f8b979b63f?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат ответа 

{
    "code":   Int,           # Код ответа (200)
    "status": "String",      # Статус ответа (success)
    "record": {              # Запись
        "status": "String",  # Статус записи ("Wait", "Progress", "Finish")
        "files": ["String"]  # Массив id записанных видеофайлов
    }
}

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

{
    "code": 200,
    "status": "success",
    "record": {
        "status": "Finish",
        "files": ["5bd37808534b441c4acf7415"]
    }
}
Описание Метод для удаления записи видеопотока по расписанию
Структура URL https://api.platformcraft.ru/1/streams/rec/schedule/del/{:stream_id}/{:record_id}
Метод DELETE
Возвращает Статус удаления записи видеопотока по расписанию 
https://api.platformcraft.ru/1/streams/rec/schedule/del/56cec7e2fa63afd0f843567d/5624cd5ac9a492f8b979b63f?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат ответа 

{
    "code": Int,        #Код ответа (200)
    "status": "String"  #Статус ответа (success)
}

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

{
    "code": 200,
    "status": "success"
}

/players

Описание Метод для создания плеера
Структура URL https://api.platformcraft.ru/1/players
Метод POST
Тип тела запроса JSON
Возвращает Информацию о созданном плеере

Формат тела запроса 

{
        "name":             "String", #имя плеера (обязательный параметр)
        "folder":           "String", #директория плеера (необязательный параметр)
        "videos": {                   #словарь объектов видео (обязательный параметр)
            "String": "String",       #название видео в плеере: id объекта видео (обязательно хотя бы одно поле)
            ...
        },
        "screen_shot_id":   "String",         #id объекта скриншота (необязательный параметр)
        "vast_ad_tag_url" : "String",         #VAST ad tag url (необязательный параметр)
        "description": "String",              #описание плеера (необязательный параметр, не более 1500 символов)
        "tags": ["String",...],               #список тегов (необязательный параметр)
        "geo": map["String"]map["String"]Bool #геоограничения
}

Формат поля geo 

geo - словарь вида map[continent]map[country]true, где continent, country - ISO коды континентов и стран соответственно (например, EU и RU). Если country == "ALL", то разрешен доступ ко всем странам внутри континента.
Примеры:
geo = null { без ограничений }
geo = {"EU":{"ALL": true}, "NA":{"ALL": true}} { разрешить доступ в Европе и Северной Америке }
geo = {"EU": {"RU": true}} { разрешить только в России }

Примечание: все коды континентов и стран должны быть указаны с большой буквы.

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

https://api.platformcraft.ru/1/players?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

{
    "name":"player_name",
    "folder": "/test",
    "videos":{
        "360":"566bf3e9534b447f07e2baef",
        "480":"5624cd5ac9a492f8b979b63f"
    },
    "screen_shot_id":"56238961c9a492f8b979b633",
    "vast_ad_tag_url":"http://example.com/example-vast.xml",
    "description": "test description",
    "tags": ["tag1","tag2"],
    "geo": {"EU": {"RU": true}}
}

Формат ответа 

{
    "code": Int,                     #код ответа (200)
    "status": "String",              #статус ответа (success)
    "player": {                      #информация о плеере
        "id": "String",              #id плеера
        "name": "String",            #имя плеера
        "path": "String",            #путь к плееру
        "is_dir": Bool,              #папка (true) или плеер (false)
        "videos": {                  #словарь ссылок на видео
            "String": "String",      #название видео в плеере: ссылка на видео
            ...
        },
        "screen_shot_url": "String",          #ссылка на скриншот
        "vast_ad_tag_url": "String",          #VAST ad tag url
        "create_date": "String",              #дата создания плеера
        "href": "String",                     #ссылка на плеер
        "frame_tag": "String",                #код вставки плеера
        "description": "String",              #описание плеера
        "tags": ["String",...],               #список тегов
        "geo": map["String"]map["String"]Bool #геоограничения
    }
}

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

{
    "code": 200,
    "status": "success",
    "player": {
        "id": "567d3643534b4474087c221d",
        "name": "player_name",
        "path": "/test/player_name",
        "is_dir": false,
        "videos": {
            360: "cdn.platformcraft.ru/alex/example_360.mp4"
            480: "cdn.platformcraft.ru/alex/example_480.mp4"
        },
        "screen_shot_url": "cdn.platformcraft.ru/alex/example.jpg",
        "vast_ad_tag_url": "http://example.com/example-vast.xml",
        "create_date": "25.12.2015T15:27:47"
        "href": "video.platformcraft.ru/embed/567d3643534b4474087c221d",
        "frame_tag": "<iframe width="558" height="264" src="video.platformcraft.ru/embed/567d3643534b4474087c221d" frameBorder="0" scrolling="no" allowFullScreen></iframe>",
        "description": "test description",
        "tags": ["tag1","tag2"],
        "geo": {"EU": {"RU": true}}
    }
}
Описание Метод для получения списков всех плееров
Структура URL https://api.platformcraft.ru/1/players
Метод GET
Возвращает Список всех плееров
Параметры фильтрации
folder Директория, из которой нужно получить плееры. Пример: "/test". Если параметр не указан, сканирование файлов будет осуществляться по всем директориям аккаунта. Необязательный.
name Имя плеера. Пример: "test". Необязательный.
show_folders Показывать папки (show_folders=true - показывать папки наряду с плеерами). Необязательный.
Параметры пагинации
limit Количество плееров на одной странице. Необязательный, при отсутствии параметра в запросе возвращаются все плееры пользователя.
start Какое количество плееров в списке необходимо пропустить. Необязательный, учитывается только при положительном значении параметра limit.
pagingts Unix-время. Возвращаются только те плееры, время создания которых меньше или равно времени, соответствующему pagingts. Необязательный, учитывается только при положительном значении параметра limit. 
https://api.platformcraft.ru/1/players?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571&limit=2

Формат ответа 

{
    "code": Int,                         #код ответа (200)
    "status": "String",                  #статус ответа (success)
    "count": "String",                   #количество плееров
    "count_on_page": "String",           #количество плееров на странице
    "players": [                         #список плееров
        {                                #информация о плеере
            "id": "String",              #id плеера
            "name": "String",            #имя плеера
            "path": "String",            #путь к плееру
            "is_dir": Bool,              #папка (true) или плеер (false)
            "videos": {                  #словарь ссылок на видео
                "String": "String",      #название видео в плеере: ссылка на видео
                ...
            },
            "screen_shot_url": "String",          #ссылка на скриншот
            "vast_ad_tag_url": "String",          #VAST ad tag url
            "create_date": "String",              #дата создания плеера
            "href": "String",                     #ссылка на плеер
            "frame_tag": "String",                #код вставки плеера
            "description": "String",              #описание плеера
            "tags": ["String",...],               #список тегов
            "geo": map["String"]map["String"]Bool #геоограничения
        }
    ],
    "paging": {
        "next": "String",                #ссылка на след. страницу. null, если текущая страница последняя. Важно: не забывайте подписывать запрос next при отправке на сервер (см. https://doc.platformcraft.ru/filespot/api/#_1)
        "prev": "String"                 #ссылка на пред. страницу. null, если текущая страница первая. Важно: не забывайте подписывать запрос prev при отправке на сервер (см. https://doc.platformcraft.ru/filespot/api/#_1)
    }
}

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

{
    "code": 200,
    "status": "success",
    "count": 4,
    "count_on_page": 2,
    "players": [
        {
            "id": "567d3643534b4474087c221d",
            "name": "player_name",
            "path": "/test/player_name"
            "is_dir": false,
            "videos": {
                360: "cdn.platformcraft.ru/alex/example_360.mp4"
                480: "cdn.platformcraft.ru/alex/example_480.mp4"
            },
            "screen_shot_url": "cdn.platformcraft.ru/alex/example.jpg",
            "vast_ad_tag_url": "http://example.com/example-vast.xml",
            "create_date": "25.12.2015T15:27:47"
            "href": "video.platformcraft.ru/embed/567d3643534b4474087c221d",
            "frame_tag": "<iframe width="558" height="264" src="video.platformcraft.ru/embed/567d3643534b4474087c221d" frameBorder="0" scrolling="no" allowFullScreen></iframe>",
            "description": "test player",
            "tags": ["test"],
            "geo": {"EU": {"RU": true}}
        },
        {
            "id": "567d3643534b4474087c221e",
            "name": "player_name_1",
            "path": "/player_name_1",
            "is_dir": false,
            "videos": {
                360: "cdn.platformcraft.ru/alex/example_360.mp4"
                480: "cdn.platformcraft.ru/alex/example_480.mp4"
            },
            "screen_shot_url": "cdn.platformcraft.ru/alex/example.jpg",
            "vast_ad_tag_url": "http://example.com/example-vast.xml",
            "create_date": "25.12.2015T15:27:48"
            "href": "video.platformcraft.ru/embed/567d3643534b4474087c221e",
            "frame_tag": "<iframe width="558" height="264" src="video.platformcraft.ru/embed/567d3643534b4474087c221e" frameBorder="0" scrolling="no" allowFullScreen></iframe>",
            "description": "test player",
            "tags": [],
            "geo": null
        }
    ],
    "paging": {
        "next": "api.platformcraft.ru/1/players?pagingts=1525858519&limit=2&start=2",
        "prev": null
    }
}
Описание Метод для получения информации о плеере
Структура URL https://api.platformcraft.ru/1/players/{:player_id}
Метод GET
Возвращает Информацию о плеере 
https://api.platformcraft.ru/1/players/567d3643534b4474087c221d?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571

Формат ответа 

{
    "code": Int,                     #код ответа (200)
    "status": "String",              #статус ответа (success)
    "player": {                      #информация о плеере
        "id": "String",              #id плеера
        "name": "String",            #имя плеера
        "path": "String",            #путь к плееру
        "is_dir": Bool,              #папка (true) или плеер (false)
        "videos": {                  #словарь ссылок на видео
            "String": "String",      #название видео в плеере: ссылка на видео
            ...
        },
        "screen_shot_url": "String",          #ссылка на скриншот
        "vast_ad_tag_url": "String",          #VAST ad tag url
        "create_date": "String",              #дата создания плеера
        "href": "String",                     #ссылка на плеер
        "frame_tag": "String",                #код вставки плеера
        "description": "String",              #описание плеера
        "tags": ["String",...],               #теги
        "geo": map["String"]map["String"]Bool #геоограничения
    }
}

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

{
    "code": 200,
    "status": "success",
    "player": {
        "id": "567d3643534b4474087c221d",
        "name": "player_name",
        "path": "/test/player_name",
        "is_dir": false,
        "videos": {
            360: "cdn.platformcraft.ru/alex/example_360.mp4"
            480: "cdn.platformcraft.ru/alex/example_480.mp4"
        },
        "screen_shot_url": "cdn.platformcraft.ru/alex/example.jpg",
        "vast_ad_tag_url": "http://example.com/example-vast.xml",
        "create_date": "25.12.2015T15:27:47"
        "href": "video.platformcraft.ru/embed/567d3643534b4474087c221d",
        "frame_tag": "<iframe width="558" height="264" src="video.platformcraft.ru/embed/567d3643534b4474087c221d" frameBorder="0" scrolling="no" allowFullScreen></iframe>",
        "description": "test player",
        "tags":["tag1","tag2"],
        "geo": {"EU": {"RU": true}}
    }
}
Описание Метод для удаления плеера
Структура URL https://api.platformcraft.ru/1/players/{:player_id}
Метод DELETE
Возвращает Статус удаления плеера

Дополнительные параметры

delete_related - удалять или не удалять файлы, связанные с плеером (true/false)

https://api.platformcraft.ru/1/players/567d3643534b4474087c221d?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571&delete_related=true

Формат ответа 

{
    "code": Int,       #код ответа (200)
    "status": "String" #статус ответа (success)
}

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

{
    "code": 200,
    "status": "success"
}
Описание Изменяет плеер с заданным id
Структура URL https://api.platformcraft.ru/1/players/:id
Метод PUT
Тип тела запроса JSON
Возвращает Статус операции изменения плеера

Формат тела запроса 

{
    "name":           "String",   #новое имя плеера
    "folder":           "String", #новая директория плеера, пример: "/test". Параметр игнорируется при пустом значении
    "videos": {                   #словарь объектов видео
        "String": "String",       #название видео в плеере: id объекта видео
        ...
    },
    "screen_shot_id": "String",           #id объекта скриншота
    "description": "String",              #описание плеера (не более 1500 символов)
    "tags": ["String",...],               #список тегов
    "geo": map["String"]map["String"]Bool #геоограничения
}

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

{
    "code": 200,
    "status": "success",
}

/download

Описание Метод для создания задачи на загрузку файла по URL
Структура URL https://api.platformcraft.ru/1/download
Метод POST
Возвращает Статус постановки задачи
Примечание Максимальное число одновременно активных задач: 200
Параметры
url URL загружаемого файла. Пример: "http://test-domain.ru/test/test.mp4". Обязательный параметр.
path Директория загрузки файла. Пример: "/test". При отсутствии этого параметра загружаемые файлы размещаются в корневой директории.
name Имя файла. Пример: "test.mp4". При отсутствии этого параметра имя файла определяется автоматически.
Параметры для автоперекодирования и автоплеера
autoencoding Автоматическая конвертация видеофайла (возможные значения: true, false). Необязательный, учитывается только для видеофайлов. Параметр игнорируется для пользователей, не подписанных на услугу конвертации видеофайлов.
presets Идентификаторы пресетов для автоперекодирования, разделенные ",". Необязательный, учитывается только при autoencoding=true. Пример: presets=566b0fbf044dfe64f2000002,566b0fbf044dfe64f2000003
del_original Удалить оригинальный файл после автоперекодирования (возможные значения: true, false). Необязательный, учитывается только при autoencoding=true.
autoplayer Автоматическое создание плеера (возможные значения: true, false). Необязательный, учитывается только для видеофайлов. Если autoencoding=false, плеер будет создан из одного оригинального файла. Если autoencoding=true, то плеер будет создан из перекодированных видеофайлов. 
    https://api.platformcraft.ru/1/download?apiuserid=test&timestamp=1450342665&hash=217ea22038abe3a16a2b0284e7b3d9a4487013ed9e832418befc49886a27d571&url=http://test-domain.ru/test/test.mp4&path=/test

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

{
    "code":         200,
    "status":       "success",
    "message":      "Task create success.",
    "active_tasks": 1,
    "task_id":      "56ea79e2534b4423135ebfaa"
}

/download_tasks

Описание Метод для получения списка задач на загрузку файлов
Структура URL https://api.platformcraft.ru/1/download_tasks
Метод GET
Возвращает Список задач

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

{
    "code": 200,
    "status": "success",
    "count": 2,
    "tasks": [
        {
            "id": "56365b04044dfe6917000002",
            "category": "download",
            "title": "Download test1.mp4",
            "body": "Please wait.",
            "status": "Progress",
            "time_start": "01.11.2015T21:33:40",
            "time_finish": "",
            "lock": true
        },
        {
            "id": "57011e2a534b44741fc67880"
            "category": "download"
            "title": "Download abc.mp4"
            "body": "Download success."
            "status": "Completed"
            "time_start": "03.04.2016T16:44:10"
            "time_finish": "03.04.2016T16:44:11"
            "lock": false
        }
    ]
}
Описание Метод для получения информации о задаче на загрузку файла
Структура URL https://api.platformcraft.ru/1/download_tasks/{:task_id}
Метод GET
Возвращает Информацию о задаче

Формат ответа 

{
    "code":   Int,        #код ответа
    "files":  ["String"], #массив ID загруженных файлов
    "status": "String",   #статус ответа
    "task": {
        "id":          "String" #ID задачи
        "category":    "String" #тип задачи
        "title":       "String" #название задачи
        "body":        "String" #информация о задаче
        "status":      "String" #статус задачи
        "time_start":  "String" #время начала
        "time_finish": "String" #время окончания
        "lock":        Bool     #блокировка
    }
}

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

{
    "code": 200,
    "files":["56ea7c4e534b44353536586c"],
    "status": "success",
    "task": {
        "id": "57011e2a534b44741fc67880"
        "category": "download"
        "title": "Download abc.mp4"
        "body": "Download success."
        "status": "Completed"
        "time_start": "03.04.2016T16:44:10"
        "time_finish": "03.04.2016T16:44:11"
        "lock": false
    }
}
Описание Метод для удаления задачи из очереди (удалить можно только незаблокированную задачу)
Структура URL https://api.platformcraft.ru/1/download_tasks/{:task_id}
Метод DELETE
Возвращает Статус удаления задачи

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

{
    "code": 200,
    "message": "Task delete success.",
    "status": "success"
}

/transcoder/presets

Описание Метод для получения списка доступных форматов для перекодирования
Структура URL https://api.platformcraft.ru/1/transcoder/presets
Метод GET
Возвращает Список форматов для перекодирования

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

{
    "code": 200,
    "count": 3,
    "presets": [
        {
            "id": "566b0fbf044dfe64f2000002",
            "name": "System preset: Generic 1080p",
            "container": "mp4",
            "video": {
                "codec": "H.264",
                "bit_rate": "5400",
                "fps": "29.97",
                "max_width": "1920",
                "max_height": "1080"
            },
            "audio": {
                "codec": "AAC",
                "bit_rate": "160",
                "sample_rate": "44100",
                "channels": "2"
            },
            watermarks: {
                BottomLeft: {
                    horizontal_align: "Left",
                    horizontal_offset: "10%",
                    vertical_align: "Bottom",
                    vertical_offset: "10%",
                    max_height: "10%",
                    max_width: "10%",
                    opacity: "100",
                    sizing_policy: "ShrinkToFit"
                },
                BottomRight: {
                    horizontal_align: "Right",
                    horizontal_offset: "10%",
                    vertical_align: "Bottom",
                    vertical_offset: "10%",
                    max_height: "10%",
                    max_width: "10%",
                    opacity: "100",
                    sizing_policy: "ShrinkToFit"
                },
                Full: {
                    horizontal_align: "Left",
                    horizontal_offset: "0%",
                    vertical_align: "Top",
                    vertical_offset: "0%",
                    max_height: "100%",
                    max_width: "100%",
                    opacity: "100",
                    sizing_policy: "Fit"
                },
                TopRight: {
                    horizontal_align: "Right",
                    horizontal_offset: "10%",
                    vertical_align: "Top",
                    vertical_offset: "10%",
                    max_height: "10%",
                    max_width: "10%",
                    opacity: "100",
                    sizing_policy: "ShrinkToFit"
                }
            }
        },
        {
            "id": "566b0fbf044dfe64f2000003",
            "name": "System preset: Generic 720p",
            "container": "mp4",
            "video": {
                "codec": "H.264",
                "bit_rate": "2400",
                "fps": "29.97",
                "max_width": "1280",
                "max_height": "720"
            },
            "audio": {
                "codec": "AAC",
                "bit_rate": "160",
                "sample_rate": "44100",
                "channels": "2"
            },
            watermarks: {...}
        },
        {
            "id": "566b0fbf044dfe64f2000004",
            "name": "System preset: Generic 480p 16:9",
            "container": "mp4",
            "video": {
                "codec": "H.264",
                "bit_rate": "1200",
                "fps": "29.97",
                "max_width": "854",
                "max_height": "480"
            },
            "audio": {
                "codec": "AAC",
                "bit_rate": "128",
                "sample_rate": "44100",
                "channels": "2"
            },
            watermarks: {...}
        }
    ]
}

/transcoder

Описание Метод для создания задачи на перекодирование
Структура URL https://api.platformcraft.ru/1/transcoder/{:object_id}
Метод POST
Тип тела запроса JSON
Возвращает Статус постановки задачи
Примечание Максимальное число одновременно активных задач: 200

Формат тела запроса 

{
   "presets": ["presetID",...],        # список id форматов для перекодирования. Допустимо пустое поле, если start>0 или duration>0
   "path": "String",                   # директория загрузки файла. Необязательный параметр. По умолчанию новые файлы размещаются в директории транскодируемого файла.
   "watermarks": {"String": "String"}, # словарь вида {watermark_id: object_id}, где watermark_id - watermark id, object_id - id картинки (поддерживаемые расширения - .png и .jpg). Необязательный параметр. Добавляет водяной знак на видеофайл. См. метод GET /transcoder/presets для получения информации о watermark_id.
   "del_original": Bool,               # удалять/не удалять оригинальный файл после транскодирования (по умолчанию: false)
   "start": Int,                       # позиция начала транскодирования (количество секунд от начала файла, по умолчанию: 0)
   "duration": Int                     # длительность транскодирования (в секундах, по умолчанию: 0). Если duration==0, то транскодируется весь файл, начиная с позиции start.
}

Примечание: Если поле presets пустое и start>0 или duration>0, то метод выполнит обрезку медиафайла без выполнения транскодирования.

Пример тела запроса 

{
   "presets": ["5676a27cf9cb101634000002","5676a27cf9cb101634000003"],
   "path": "/test",
   "watermarks": {"Full": "5adfa939534b446a607d9937"},
   "del_original": false
}

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

{
    "code":         200,
    "status":       "success",
    "message":      "Task create success.",
    "active_tasks": 2,
    "task_id":      "56ea79e2534b4423135ebfd3"
}
Описание Метод для создания задачи на конкатенацию файлов
Структура URL https://api.platformcraft.ru/1/transcoder?concat
Метод POST
Тип тела запроса JSON
Возвращает Статус постановки задачи

Формат тела запроса 

{
   "files": ["String",...], # упорядоченный список id файлов для конкатенации (от 2-х до 20 файлов)
   "path": "String"         # директория загрузки файла. Необязательный параметр. По умолчанию новые файлы размещаются в корневой директории.
   "name": "String"         # имя файла
}

Пример тела запроса 

{
    "files": ["5adfa9bc534b446a7f5d3c0c","5ade3ad1534b445140d49539"],
    "path": "/dir",
    "name": "concat.mp4"
}

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

{
    "code":         200,
    "status":       "success",
    "message":      "Task create success.",
    "active_tasks": 2,
    "task_id":      "56ea79e2534b4423135ebfd3"
}
Описание Метод для создания задачи на перекодирование HLS
Структура URL https://api.platformcraft.ru/1/transcoder/hls/{:object_id}
Метод POST
Тип тела запроса JSON
Возвращает Статус постановки задачи

Формат тела запроса 

{
   "presets": ["presetID",...], #список id форматов для перекодирования
   "segment_duration": Int      #Длительность сегмента видео в сек. от 1 до 60
}

Пример тела запроса 

{
   "presets": ["5693b900534b440cd053f5a5","5693b900534b440cd053f5a3"],
   "segment_duration": 20
}

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

{
    "code":         200,
    "status":       "success",
    "message":      "Task create success.",
    "active_tasks": 2,
    "task_id":      "56ea79e2534b4423135ebfd3"
}
Описание Метод для получения вырезки скриншота в указанный момент времени
Структура URL https://api.platformcraft.ru/1/transcoder/screenshot/{:object_id}
Метод POST
Тип тела запроса application/json
Возвращает Информацию о созданном скриншоте

Формат тела запроса 

{
    "position": Float,      # позиция скриншота от начала файла (секунды)
    "name":     "String",   # имя скриншота
    "path":     "String"    # директория загрузки
}

Пример тела запроса 

{
    "position": 10.5,
    "name": "screen.jpg",
    "path": "/black/screens"
}

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

{
    "code": 200,
    "status": "success",
    "object": {
        "id": "6087cdb60e47cf6292960fef",
        "name": "screen.jpg",
        "path": "/black/screens/screen.jpg",
        "is_dir": false,
        "size": 47642,
        "content_type": "image/jpeg",
        "create_date": "27.04.2021T11:39:19",
        "resource_url": "api.platformcraft.ru/1/objects/6087cdb60e47cf6292960fef",
        "cdn_url": "cdn.platformcraft.ru/example/black/screens/screen.jpg",
        "private": false,
        "status": "ok",
        },
    "storage": {
        "used": 400587972741,
        "limit": 536870912000
}
}
Описание Метод для создания задачи на разделение видеофайла на составляющие
Структура URL https://api.platformcraft.ru/1/transcoder?decompose
Метод POST
Тип тела запроса JSON
Возвращает Статус постановки задачи

Формат тела запроса 

{
    "file": "String",                       # id входного видеофайла
    "path": "String",                       # папка, в которой будут размещены сгенерированные файлы (если указанная папка не существует, она будет создана автоматически)
    "subtitle_type": "String",              # Тип субтитров (возможные значения: ttml, vtt)
    "subtitle_langs": ["String",...]        # Языки субтитров
}

Пример тела запроса 

{
    "file": "5e1bb131ef3db56034d1bfcc",     
    "path": "/test",                        
    "subtitle_type": "ttml",               
    "subtitle_langs": ["rus", "eng"]        
}

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

{
    "code":         200,
    "status":       "success",
    "message":      "Task create success.",
    "active_tasks": 2,
    "task_id":      "56ea79e2534b4423135ebfd3"
}

/transcoder_tasks

Описание Метод для получения списка задач на перекодирование
Структура URL https://api.platformcraft.ru/1/transcoder_tasks
Метод GET
Возвращает Список задач

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

{
    "code": 200,
    "status": "success",
    "count": 3,
    "tasks": [
        {
            "id": "56365b04044dfe6917000002",
            "category": "encoding",
            "title": "Encoding Копия test.360p.mp4",
            "body": "Please wait.",
            "status": "Progress",
            "time_start": "01.11.2015T21:33:40",
            "time_finish": "",
            "lock": true
        },
        {
            "id": "566b3a9d044dfe7381000002",
            "category": "encoding",
            "title": "Encoding test (480p).mp4",
            "body": "Internal server error. Please try again later.",
            "status": "Error",
            "time_start": "12.12.2015T00:05:33",
            "time_finish": "12.12.2015T00:05:47",
            "lock": false
        },
        {
            "id": "566b4173044dfe771c000001",
            "category": "encoding",
            "title": "Encoding test (480p).mp4",
            "body": "Encoding video success.",
            "status": "Completed",
            "time_start": "12.12.2015T00:34:43",
            "time_finish": "12.12.2015T00:35:56",
            "lock": false
        }
    ]
}
Описание Метод для получения информации с конкретным ID
Структура URL https://api.platformcraft.ru/1/transcoder_tasks/{:task_id}
Метод GET
Возвращает Информацию о задаче

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

{
    "code": 200,
    "files":["56ea7c4e534b44353536586c"],
    "status": "success",
    "task": {
        "id": "56365b04044dfe6917000002",
        "category": "encoding",
        "title": "Encoding Копия test.360p.mp4",
        "body": "Please wait.",
        "status": "Progress",
        "time_start": "01.11.2015T21:33:40",
        "time_finish": "",
        "lock": true
    }
}
Описание Метод для получения информации о HLS задаче с конкретным ID
Структура URL https://api.platformcraft.ru/1/transcoder_tasks/hls/{:task_id}
Метод GET
Возвращает Информацию о HLS задаче

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

{
    "code":200,
    "files":{
        "master_playlist":"56ea7c4e534b44353536586c",
        "media":[
            {
                "playlist":"56ea7c4e534b44353536586d",
                "files":[
                    "56ea7c4f534b44353536586e",
                    "56ea7c50534b44353536586f",
                    "56ea7c50534b443535365870"
                ]
            },
            {
                "playlist":"56ea7c55534b443535365878",
                "files":[
                    "56ea7c55534b443535365879",
                    "56ea7c55534b44353536587a",
                    "56ea7c56534b44353536587b"
                ]
            }
        ]
    },
    "status":"success",
    "task":{
        "id":"56ea7c2f534b440c83fe85bc",
        "category":"encoding",
        "title":"Encoding abc.mp4",
        "body":"Encoding video success.",
        "status":"Completed",
        "time_start":"17.03.2016T12:43:11",
        "time_finish":"17.03.2016T12:43:53",
        "lock":false
    }
}
Описание Метод для удаления задачи из очереди (удалить можно только незаблокированную задачу)
Структура URL https://api.platformcraft.ru/1/transcoder_tasks/{:task_id}
Метод DELETE
Возвращает Статус удаления задачи

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

{
    "code": 200,
    "message": "Task delete success.",
    "status": "success"
}

<!---

/smil

Описание Метод для создания smil файла
Структура URL https://api.platformcraft.ru/1/smil/multitrack
Метод POST
Тип тела запроса JSON
Возвращает Информацию о созданном файле smil

Формат тела запроса 

{
    "name":             "String",           # Имя файла. Обязательный.
    "videos": ["String","String",...],      # Массив id объектов видео. Необходимо, чтобы видеофайлы находились в одной директории. Обязательный.
    "audios": ["String","String",...],      # Массив id объектов аудио. Необходимо, чтобы аудиофайлы находились в той же директории, что и видеофайлы
    "subtitles": "String"                   # Субтитры в формате ttml
}

Пример тела запроса 

{
    "name": "test.smil",
    "videos": ["57717eff702b935217a3fc82","57717ef978c56850d5796407"],
    "audios": ["57717eff702b935217a3fc83","57717ef978c56850d5796408"],
    "subtitles": "5f88c048ef3db567202689b7"
}

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

    Формат ответа: идентичен ответу на "POST /objects" (см. https://doc.platformcraft.ru/filespot/api/#objects)

Формат HLS ссылки 

    https://cdn.platformcraft.ru/example-vod/_definst_/smil:example{path_to_smil_file}/playlist.m3u8
    path_to_smil_file - путь до файла внутри аккаунта (object.path)

-->

/storage

Описание Метод для получения информации о хранилище
Структура URL https://api.platformcraft.ru/1/storage
Метод GET
Возвращает Информацию об объеме хранения

Формат ответа 

{
    "code":     Int,       #код ответа
    "status":   "String",  #статус ответа
    "storage": {
        "used": Int,       #используемый объем хранения (байты)
        "limit": Int       #максимальный объем хранения (байты)
    }
}

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

{
    "code": 200,
    "status": "success",
    "storage": {
        "used": 97537237,
        "limit": 107374182
    }
}

Ошибки

Формат ответа 

{
    "code":     Int,       #код ответа
    "status":   "String",  #статус ответа (fail)
    "msg_user": "String",  #описание ошибки
    "msg_dev":  "String",  #детальное описание ошибки
    "doc":      "String",  #ссылка на документацию
    "advanced": "String"   #дополнительная информация
}

Коды ошибок 

400 - некорректный запрос,
403 - доступ запрещен,
404 - запрашиваемый ресурс не найден.

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

{
    "code": 400
    "status": "fail"
    "msg_user": "Api ID, timestamp and hash are required."
    "msg_dev": "Check Api id, timestamp and hash."
    "doc": "http://doc.platformcraft.ru/filespot/api/#access"
    "advanced": null
}

Библиотеки

platformcraft-filespot для Ruby