Difference between revisions of "Engine HTTP API"

From Ace Stream Wiki
Jump to: navigation, search
(Новая страница: «==Общее описание== Начиная с версии 3.1 появилась возможность управлять движком по протокол…»)
 
(Методы API)
Line 5: Line 5:
 
В описаниях методов <tt>''<engine_address>''</tt> - это ip-адрес движка, <tt>''<engine_port>''</tt> - http-порт движка.
 
В описаниях методов <tt>''<engine_address>''</tt> - это ip-адрес движка, <tt>''<engine_port>''</tt> - http-порт движка.
 
Все методы принимают такие общие параметры:
 
Все методы принимают такие общие параметры:
*'''sid''' - идентификатор сессии
+
*'''sid''' - [[#Идентификатор сессии|идентификатор сессии]] (необязательный параметр)
  
 
===Получение потока в формате HLS===
 
===Получение потока в формате HLS===
Line 30: Line 30:
 
Пример:
 
Пример:
 
  <nowiki>http://127.0.0.1:6878/ace/getstream?id=dd1e67078381739d14beca697356ab76d49d1a2d</nowiki>
 
  <nowiki>http://127.0.0.1:6878/ace/getstream?id=dd1e67078381739d14beca697356ab76d49d1a2d</nowiki>
 +
 +
==Идентификатор сессии==

Revision as of 15:18, 24 April 2015

Общее описание

Начиная с версии 3.1 появилась возможность управлять движком по протоколу HTTP. Для передачи команды движку нужно отправить HTTP GET запрос на http-порт движка. Порт по умолчанию: 6878.

Методы API

В описаниях методов <engine_address> - это ip-адрес движка, <engine_port> - http-порт движка. Все методы принимают такие общие параметры:

Получение потока в формате HLS

http://<engine_address>:<engine_port>/ace/manifest.m3u8

В ответ на данную команду движок выдаст HLS плейлист для воспроизведения запрашиваемого контента. В случае ошибки будет возвращен HTTP код 4хх либо 5хх с кратким описанием ошибки.

Воспроизведение в формате HLS доступно только для live-трансляций. При попытке запустить VOD с помощью данной команды движок выдаст ошибку.

Параметры:

  • id - идентификатор контента (content id)

Пример:

http://127.0.0.1:6878/ace/manifest.m3u8?id=dd1e67078381739d14beca697356ab76d49d1a2d

Получение потока по HTTP

http://<engine_address>:<engine_port>/ace/getstream

В ответ на данную команду движок будет выдавать данные в виде http progressive download. В случае ошибки будет возвращен HTTP код 4хх либо 5хх с кратким описанием ошибки.

Параметры:

  • id - идентификатор контента (content id)

Пример:

http://127.0.0.1:6878/ace/getstream?id=dd1e67078381739d14beca697356ab76d49d1a2d

Идентификатор сессии