- API
- File encodings
GET
https://send.now/api/file/encodings?key=1ltghrilhllgrx2b2&file_code=jfru5kl9dhrt
| Parameters |
Description |
Example |
Format |
Required |
| key |
API-Key |
1ltghrilhllgrx2b2 |
String |
yes |
| file_code |
File code of one of your videos |
jfru5kl9dhrt |
String |
yes |
cURL example
curl --include \
'https://send.now/api/file/encodings?key=1ltghrilhllgrx2b2&file_code=jfru5kl9dhrt'
Response
{
"msg": "OK",
"result": {
"file_code": "jfru5kl9dhrt",
"name": "holiday.mp4",
"length": 182,
"original": {
"size": 41203885,
"width": 1920,
"height": 1080,
"length": 182,
"playable": 1
},
"qualities": [
{
"quality": "l",
"name": "Low",
"status": "DONE",
"progress": 100,
"size": 6419320,
"width": 640,
"height": 360,
"length": 182,
"video_bitrate": 220,
"audio_bitrate": 64
},
{
"quality": "n",
"name": "Normal",
"status": "DONE",
"progress": 100,
"size": 14208551,
"width": 1280,
"height": 720,
"length": 182,
"video_bitrate": 520,
"audio_bitrate": 128
},
{
"quality": "h",
"name": "HD",
"status": "ENCODING",
"progress": 42
}
]
},
"status": 200,
"server_time": "2024-08-26 12:19:28"
}
Notice
|
The versions of one of your videos: the ones that are ready and the ones that are still being made. The uploaded file is never replaced; the versions are extra files next to it. |
|
Without file_code the call answers with the encoding queue of your account, the same list as Video encodings. |
|
qualities has one entry for each quality the video has or is getting, lowest first: l Low, n Normal, h HD, x UHD. status is DONE, or the status of the job in the queue: PENDING, ENCODING, STUCK (no word from the encoder for 5 minutes), ERROR (see Video encodings). progress is a percentage. |
|
A finished quality has size in bytes, width and height in pixels, length in seconds and the bitrates of the video and of the sound in kbit/s. A quality that is being made again shows the status of the new job and the numbers of the version that is there. |
|
original is the file you uploaded. playable is 1 when a browser can play it as it is (MP4, H.264, AAC): then q=o of File direct link gives a stream link to it (for your own videos). |
|
The links of a version are made by File direct link (q= and hls=1). |
|
Only for a video of your account, or for any file when the key is an admin's. The video features have to be on for the account of the owner of the file (HD + Mobile), else the reply is 403. |
|
Errors: 400 the file code is not valid or the file is not a video, 403 the video features are not on for the account, 404 no such file (also for a file in the trash). |
Status code
| 200 |
Everything is OK. Request succeeded |
| 400 |
Bad request (not a valid file code, or the file is not a video) |
| 403 |
Permission denied (the video features are not on for the account) |
| 404 |
File not found |