Inbox

These endpoints have to be used with a working Karaoke Mugen Server instance. It allows the client to query the inbox of songs submitted by other users, download them and delete them once the song has been added to database.

Get inbox

getInbox Operator user required Frontend can be closed, restricted or open

Returns inbox content after successfully connecting to the server

Your request needs to have a valid onlineAuthorization header from previously logging in with a valid online user.

Request
{
    repoName: 'kara.moe'
}
Response
[
    {
        inid: <inbox item id>
        name: 'ENG - My little series - OP - My little song'
        username_downloaded?: 'Aeden' //Who downloaded the song last
        downloaded_at?: <Date>;
        created_at: <Date>;
        kara: {
            file: 'ENG - My little series - OP - My little song.kara.json',
            data: <KaraFile data in JSON>
        };
        lyrics: {
            file: 'ENG - My little series - OP - My little song.ass',
            data: <File contents as a string>
        };
        extra_tags: [] // If any new tags are included with this song, they'll be listed there, with file and data properties
        mediafile: 'ENG - My little series - OP - My little song.mp4'
        gitlab_issue: '2098'
        fix: false // true if this is an edit/fix of an existing song, false if brand new
        contact: ''
    },
    ...
]
Response
{
    code: 500,
    message: {
        code: 'INBOX_VIEW_ERROR'
    }
}

Download song from inbox

downloadKaraFromInbox Operator user required Frontend can be closed, restricted or open

Download and integrate song from inbox into the app's database.

Response
{
    code: 500,
    message: {
        code: 'DOWNLOAD_KARA_FROM_INBOX_ERROR'
    }
}

Delete song from inbox

downloadKaraFromInbox Operator user required Frontend can be closed, restricted or open

Deletes a song once it's been integrated successfully in the main database by a maintainer.

Response
{
    code: 500,
    message: {
        code: 'DELETE_KARA_IN_INBOX_ERROR'
    }
}