GAganjoor
Recitation

Moderate pending narration (for moderating other users' recitations you also need recitation:moderate permission) (Auth policies: recitation:publish)

Changed on
put/api/audio/moderate/{id}

Request

  • Base URL
    https://api.ganjoor.net (the document declares no server; this is the origin it was published from)
  • Auth
    API key in header Authorization

Path parameters

idinteger required

Request body

result0 | 1 | 2

Moderation Result

messagestring nullable

Rejection Message

Response

OK

idinteger

Id

ganjoorAudioIdinteger

Final data is actually exported to a MySQL database which this auto increment field is its key

ganjoorPostIdinteger

Ganjoor Post Id

poemFullTitlestring nullable

Poem Full Title

poemFullUrlstring nullable

Poem Full Url (without domain name)

audioOrderinteger

This determines where an audio is displayed between a list of sounds related to a specfic poem

fileNameWithoutExtensionstring nullable

Using this field content you would determine xml, mp3 and ogg file names

soundFilesFolderstring nullable

combining this with RMuseum.Models.GanjoorAudio.ViewModels.RecitationViewModel.FileNameWithoutExtension + .ext would preduce relative path of sound files on our file server the full path would become [HOMEPath] + '/i/' + this value

remoteMp3FilePathstring nullable

MP3 File Path

mp3Urlstring nullable

MP3 url

remoteOggFilePathstring nullable

OGG File Path

oggUrlstring nullable

OGG url

remoteXMLFilePathstring nullable

This is also a legacy field

xmlUrlstring nullable

XML url

audioTitlestring nullable

Audio Title

audioArtiststring nullable

Audio Artist

audioArtistUrlstring nullable

Audio Artist Url

audioSrcstring nullable

Audio Source

audioSrcUrlstring nullable

Audio Src Url

legacyAudioGuidstring uuid

Legacy Audio Guid

mp3FileCheckSumstring nullable

Audio File CheckSum

mp3SizeInBytesinteger

mp3 size in bytes

oggSizeInBytesinteger

ogg size in bytes

uploadDatestring date-time

Upload Date

fileLastUpdatedstring date-time

File Last Updated

reviewDatestring date-time

Review Date (Approve or Reject)

localMp3FilePathstring nullable

MP3 File local path on Windows Server (if item is not rejected probably it is not valid and it is deleted)

localXmlFilePathstring nullable

XML File local path on Windows Server (if item is not rejected probably it is not valid and it is deleted)

audioSyncStatus0 | 1 | 2 | 4 | 16

Audio Synchronization Status (binary combination is acceptable)

reviewStatus0 | 1 | 2 | 3 | 4 | -1

Audio Review Status

reviewMsgstring nullable

Review Message

recitationType0 | 1 | 1000

recitation type

inSyncWithTextboolean

in sync with text

Example response

{
  "owner": {
    "username": "test",
    "email": "email@domain.com",
    "phoneNumber": "+989121234567",
    "firstName": "Hamid Reza",
    "surName": "Mohammadi"
  }
}

Changes

  • 493e82d8a523Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status