bililive-go/API.md

# Bililive-go API


* `GET /live` Get all live info 
    - Request:  
        ```text
        method: GET
        path: /live
        token: 114514
        ```
    - Response:   
        ```json
        {
            "err_no": 0,
            "err_msg": "",
            "data": {
                "lives": [
                    {
                        "id": "dad99e07cf99226b928143e7bd55b6e1",
                        "live_url": "https://live.bilibili.com/953650",
                        "info": {
                            "host_name": "真·凤舞九天",
                            "room_name": "尬聊",
                            "status": true
                        },
                        "is_listening": true,
                        "is_recoding": true
                    },
                    {
                        "id": "8cfc58ff74b31970899c0fe69345c222",
                        "live_url": "https://www.panda.tv/10300",
                        "info": {
                          "host_name": "司机王老菊",
                          "room_name": "【王老菊】",
                          "status": false
                        },
                        "is_listening": true,
                        "is_recoding": false
                    }
                ]
            }
        }
        ```
        
* `GET /live/{id}` Get live info by id
    - Request:  
        ```text
        method: GET
        path: /live/8cfc58ff74b31970899c0fe69345c222
        token: 114514
        ```
    - Response:
        ```json
        {
            "err_no": 0,
            "err_msg": "",
            "data": {
                "id": "8cfc58ff74b31970899c0fe69345c222",
                "live_url": "https://www.panda.tv/10300",
                "info": {
                    "host_name": "司机王老菊",
                    "room_name": "【王老菊】",
                    "status": false
                },
                "is_listening": true,
                "is_recoding": false
            }
        }
        ```
        
* `DELETE /live/{id}` Delete live by id
    - Request:  
        ```text
        method: DELETE
        path: /live/8cfc58ff74b31970899c0fe69345c222
        token: 114514
        ```
    - Response:
        ```json
        {
            "err_no": 0,
            "err_msg": "",
            "data": "OK"
        }
        ```

* `GET /lives/{id}/start` Start listen live by id
    - Request:  
        ```text
        method: GET
        path: /live/8cfc58ff74b31970899c0fe69345c222/start
        token: 114514
        ```
    - Response:
        ```json
        {
            "err_no": 0,
            "err_msg": "",
            "data": {
                "id": "8cfc58ff74b31970899c0fe69345c222",
                "live_url": "https://www.panda.tv/10300",
                "info": {
                    "host_name": "司机王老菊",
                    "room_name": "【王老菊】",
                    "status": false
                },
                "is_listening": true,
                "is_recoding": false
            }
        }
        ```
        
* `GET /lives/{id}/stop` Stop listen and record live by id
    - Request:  
        ```text
        method: GET
        path: /live/8cfc58ff74b31970899c0fe69345c222/stop
        token: 114514
        ```
    - Response:
        ```json
        {
            "err_no": 0,
            "err_msg": "",
            "data": {
                "id": "8cfc58ff74b31970899c0fe69345c222",
                "live_url": "https://www.panda.tv/10300",
                "info": {
                    "host_name": "司机王老菊",
                    "room_name": "【王老菊】",
                    "status": false
                },
                "is_listening": false,
                "is_recoding": false
            }
        }
        ```
        
* `GET /config` Get config info
    - Request:  
        ```text
        method: GET
        path: /config
        token: 114514
        ```
    - Response:
        ```json
        {
            "RPC": {
                "Enable": true,
                "Port": "127.0.0.1:8080",
                "Token": "114514",
                "TLS": {
                    "Enable": false,
                    "CertFile": "",
                    "KeyFile": ""
                }
            },
            "LogLevel": "info",
            "Interval": 15,
            "OutPutPath": "/Users/chigusa/Movies",
            "LiveRooms": [
                "https://live.bilibili.com/953650",
                "https://live.bilibili.com/146910"
            ]
        }
        ```
        
* `PUT /config` Save lives info to config file
    - Request:  
        ```text
        method: PUT
        path: /config
        token: 114514
        ```
    - Response:
        ```json
        {
            "err_no": 0,
            "err_msg": "",
            "data": "OK"
        }
        ```

* `GET /files/` A basic file server for out put path
    - Request:  
        ```text
        method: PUT
        path: /files
        token: 114514
        ```
    - Response:
        ```html
        <pre>
            <a href="%5B2018-05-12%2021-47-52%5D%5B%E7%9C%9F%C2%B7%E5%87%A4%E8%88%9E%E4%B9%9D%E5%A4%A9%5D%5B%E5%B0%AC%E8%81%8A%5D.flv">[2018-05-12 21-47-52][真·凤舞九天][尬聊].flv</a>
            <a href="%5B2018-05-12%2021-54-27%5D%5B%E7%9C%9F%C2%B7%E5%87%A4%E8%88%9E%E4%B9%9D%E5%A4%A9%5D%5B%E5%B0%AC%E8%81%8A%5D.flv">[2018-05-12 21-54-27][真·凤舞九天][尬聊].flv</a>
            <a href="%5B2018-05-12%2021-56-22%5D%5B%E7%9C%9F%C2%B7%E5%87%A4%E8%88%9E%E4%B9%9D%E5%A4%A9%5D%5B%E5%B0%AC%E8%81%8A%5D.flv">[2018-05-12 21-56-22][真·凤舞九天][尬聊].flv</a>
            <a href="%5B2018-05-12%2022-19-15%5D%5B%E7%9C%9F%C2%B7%E5%87%A4%E8%88%9E%E4%B9%9D%E5%A4%A9%5D%5B%E5%B0%AC%E8%81%8A%5D.flv">[2018-05-12 22-19-15][真·凤舞九天][尬聊].flv</a>
        </pre>
        ```