actual readme (api)

README.md

@@ -26,6 +26,35 @@ iptv.axenov.dev?ID
 
 Либо провернуть всё то же самое через браузер.
 
+## API
+
+Можно получать состояние плейлистов из этого сборника при помощи метода:
+
+```
+GET https://iptv.axenov.dev/getinfo=<ID>
+```
+
+где `ID` - один из идентификаторов, указанных в `playlists.ini` в квадратных скобках.
+
+Ответом может быть JSON следующего содержания:
+
+```json
+{
+    "is_online": true,
+    "count": 123,
+    "channels": [ ... ]
+}
+```
+
+где:
+* `is_online` - `bool`, доступность плейлиста
+* `count` - `uint|char[1]`, количество каналов >=0 либо `'-'` при `is_online === false`
+* `channels` - `string[]`, массив строк с названиями каналов, может быть пустым.
+
+Также ответ может быть пустым (вообще пустым, даже не `null`).
+Такое я встречал с одним конкретном плейлисте с поехавшей кодировкой.
+Лень разбираться, пофиг.
+
 ## Формат `playlists.ini`
 
 ```ini