- API
- Video encodings
GET
https://send.now/api/video/encodings?key=1ltghrilhllgrx2b2
| Parameters |
Description |
Example |
Format |
Required |
| key |
API-Key |
1ltghrilhllgrx2b2 |
String |
yes |
cURL example
curl --include \
'https://send.now/api/video/encodings?key=1ltghrilhllgrx2b2'
Response
{
"msg": "OK",
"result": [
{
"name": "holiday.mp4",
"status": "ENCODING",
"progress": 42,
"link": "https://send.now/jfru5kl9dhrt",
"file_code": "jfru5kl9dhrt",
"quality": "h"
},
{
"name": "trip.mkv",
"status": "PENDING",
"progress": 0,
"link": "https://send.now/a9xk2m4q7p1z",
"file_code": "a9xk2m4q7p1z",
"quality": "l"
},
{
"name": "trip.mkv",
"status": "PENDING",
"progress": 0,
"link": "https://send.now/a9xk2m4q7p1z",
"file_code": "a9xk2m4q7p1z",
"quality": "n"
}
],
"status": 200,
"server_time": "2024-08-26 12:19:28"
}
Notice
|
The videos of your account that are waiting to be encoded or are being encoded. A video can be on the list several times: the site makes one version of the video for each quality (quality: l Low, n Normal, h HD, x UHD), and each of them is a job of its own with its own status and progress. On a site that makes one version of a video there is no quality. |
|
progress is the percentage of the job that is done, 0 to 100. |
|
status: PENDING waiting for an encoder, ENCODING being encoded, STUCK being encoded but the encoder has not reported for 5 minutes (when the clean-up job of the site for the encoding queue is switched on, it puts such a job back in the queue), ERROR the encoding failed. |
|
A job that is finished leaves the list. The versions that are ready are in File encodings. |
|
name is the file name, file_code and link name the file. |
|
The list has at most 5000 entries: the jobs that are running first (the newest first), then the waiting ones. |
|
/api/queue/encoding gives the same list. |
Status code
| 200 |
Everything is OK. Request succeeded |
| 400 |
Bad request (e.g. wrong parameters) |
| 403 |
Permission denied |
| 404 |
File not found |
| 451 |
Unavailable
|