bluedot
Documentation / Convert

Retrieve a list of all conversion tasks

A REST API that returns a list of all AVIF conversions requested by the user.

Request

curl -x GET  
      https://avif-service-api.kokoon.cloud/avif/convert/tasks?step={step}&page_size={page_size}&page_num={page_num}&start_date={yyyy-MM-dd}&end_date={yyyy-MM-dd}
     -H "Authorization: <api_key>"
     -H "Accept: application/json"

List of request parameters

Parameter nameTypeDescription
page_sizenumber (Optional)The number of tasks to be returned per page.
If there is page_size, page_num is also required
page_numnumber (Optional)page of currently requested information
if page_size is present, page_num is also required
stepall, upload, convert, finish, error, unknownIndicates the progress of the task.
start_datestring (Optional)Indicates the time the task started.
end_datestring (Optional)Indicates the time the task ended.

Response

{
  "all_count": 100,
  "curr_count": 10,
  "page_size": 10,
  "page_num": 5,
  "start_date" : "2023-01-01",
  "end_date" : "2023-01-10",
  "step" : "finish",
  "convert_tasks" : [
    {
      "id": "835f24b0-90be-11ed-b598-cbb34621d6d4",
      "filename": "test1.jpg",
      "step": "finish"
    }, {
      "id": "835f24b0-90be-11ed-b598-cbb34621d6d5",
      "filename": "test2.jpg",
      "step": "finish"
    }, {
      "id": "835f24b0-90be-11ed-b598-cbb34621d6d6",
      "filename": "test3.jpg",
      "step": "upload"
    }, {
      "id": "835f24b0-90be-11ed-b598-cbb34621d6d7",
      "filename": "test4.jpg",
      "step": "finish"
    }
  ]
}

List of response parameters

Response fieldTypeDescription
all_countnumberIndicates the total number of items.
curr_countnumberIndicates the number of current items.
page_sizenumberIndicates the number of tasks to be returned per page.
page_numnumberIndicates the currently requested page.
convert_task.idstringconversion id
convert_task.filenamestringIndicates the name of the original file.
convert_task.stepupload, convert, finish, unknown, errorIndicates the progress of the task.
<< PrevRetrieve a task status of each conversion taskNext >>Delete/cancel a conversion task