API Documentation

Appearance

GET /backtraces/[ID] ​

Description ​

Get information about backtraces. Supports fetching all backtraces or a specific backtrace by ID.

Authentication ​

  • Required: Yes
  • Method: Bearer token

Request Headers ​

  • Authorization: Bearer [AUTH_TOKEN]
  • Accept:
    • application/json (for JSON responses)
    • application/xml (for XML responses)

Parameters ​

Query Parameters ​

Common Parameters (for both GET /backtraces/ and GET /backtraces/ID) ​

  • format: string (Optional)
    Values: json, xml
    Overrides the Accept header if provided.
  • human: boolean (Optional)
    Values: true, false
    Causes the response to be in a structured, more human-readable form.
  • show_null: boolean (Optional)
    Values: true, false
    If set to "true", the response will contain keys that are not set to a value.
  • expand_all: boolean (Optional)
    Values: true, false
    Recursively look up referenced objects and embed the respective JSON as nested objects directly into the response.
  • expand: string (Optional)
    Comma separated referenced objects (e.g. codec, user). Looks up objects referenced by ids and embed the respective JSON as nested objects directly into the response.

Parameters for Fetching Multiple Backtraces (GET /backtraces/) ​

  • start: int (Optional)
    Offset for paging. Default value: 0.
  • limit: int (Optional)
    Number of preset items per page. Default value: 1000 (max: 5000).
  • sort: string (Optional)
    Values: Any valid key name
    Sorts the output along the given key name. For example, use created_at to sort the results by the creation date.
  • direction: string (Optional)
    Sort records in ascending ("1") or descending ("-1") order. Default value: "1".
  • extracted_data.autograph_tag: string (Optional)
    Lists only backtraces that (also partially) match the given tag string.
  • status: string (Optional)
    Values: SUCCESS, QUEUED, FAILURE
    Filter result to return only jobs matching the given status.

Example Request for Listing Multiple Backtraces ​

bash
curl -X GET "https://api.xvid.com/v1/backtraces/?human=true&show_null=true&limit=2&sort=created_at&direction=-1" \
  -H "Authorization: Bearer AUTH_TOKEN"

Example Response for Listing Multiple Backtraces ​

Success (200 OK) ​

json
{
  "backtraces": [
    {
      "input": {
        "input_name": "uploads/zds7Yzgt8kV-4NwbL7Uve8ocH3Zg1Uyj/DX3_hXmBSXPR.mp4"
      },
      "pipeline": {
        "id": "547f3eede4b025bcbff38657",
        "href": "https://api.xvid.com/v1/pipelines/547f3eede4b025bcbff38657"
      },
      "file": {
        "id": "634bf2cf2e58e57387a8c668",
        "href": "https://api.xvid.com/v1/files/634bf2cf2e58e57387a8c668"
      },
      "job": {
        "id": "621127ffe4b03e4c2917fbf5"
      },
      "application": {
        "id": "54e89692e4b069d88de25f8f"
      },
      "extracted_data": [
        {
          "autograph_tag": "test33",
          "access_stats": [
            {
              "ip_address": "90.190.17.94",
              "ip_country": "Estonia",
              "ip_type": "UNK",
              "user_agent": "N/A",
              "accept_language": "N/A",
              "first_accessed_at": 1679586178400,
              "percentage_obtained": "100%",
              "highest_resolution": "352p",
              "streaming_only": "no"
            }
          ]
        }
      ],
      "status": "SUCCESS",
      "percentage_completed": 100,
      "error_msg": null,
      "error_code": null,
      "finished_at": 1679600895166,
      "version": 1,
      "user": {
        "id": "547f3eede4b025bcbff38655",
        "href": "https://api.xvid.com/v1/users/547f3eede4b025bcbff38655"
      },
      "created_at": 1679600889041,
      "updated_at": 1679600889041,
      "id": "641cacf9ba077b5e34e06acb",
      "href": "https://api.xvid.com/v1/backtraces/641cacf9ba077b5e34e06acb"
    },
    {
      "input": {
        "input_name": "uploads/ANa5OPwRH6pNa0uruGpSr8kXkFFBIa0x/DX3_copy.mp4"
      },
      "pipeline": {
        "id": "547f3eede4b025bcbff38657",
        "href": "https://api.xvid.com/v1/pipelines/547f3eede4b025bcbff38657"
      },
      "file": {
        "id": "621127ed633abbeb19252f9c",
        "href": "https://api.xvid.com/v1/files/621127ed633abbeb19252f9c"
      },
      "job": {
        "id": "621127ffe4b03e4c2917fbf5"
      },
      "application": {
        "id": "54e89692e4b069d88de25f8f"
      },
      "extracted_data": [
        {
          "autograph_tag": "test33",
          "access_stats": [
            {
              "ip_address": "90.190.17.94",
              "ip_country": "Estonia",
              "ip_type": "UNK",
              "user_agent": "N/A",
              "accept_language": "N/A",
              "first_accessed_at": 1679586178400,
              "percentage_obtained": "100%",
              "highest_resolution": "352p",
              "streaming_only": "no"
            }
          ]
        }
      ],
      "status": "SUCCESS",
      "percentage_completed": 100,
      "error_msg": null,
      "error_code": null,
      "finished_at": 1679586417112,
      "version": 1,
      "user": {
        "id": "547f3eede4b025bcbff38655",
        "href": "https://api.xvid.com/v1/users/547f3eede4b025bcbff38655"
      },
      "created_at": 1679586209879,
      "updated_at": 1679586209879,
      "id": "641c73a1aa53ed3f04c34c59",
      "href": "https://api.xvid.com/v1/backtraces/641c73a1aa53ed3f04c34c59"
    }
  ],
  "total": 115,
  "start": 0,
  "limit": 2,
  "first": {
    "href": "https://api.xvid.com/v1/backtraces/?start=0&limit=2&human=true&show_null=true&sort=created_at&direction=-1"
  },
  "last": {
    "href": "https://api.xvid.com/v1/backtraces/?start=114&limit=2&human=true&show_null=true&sort=created_at&direction=-1"
  },
  "next": {
    "href": "https://api.xvid.com/v1/backtraces/?start=2&limit=2&human=true&show_null=true&sort=created_at&direction=-1"
  },
  "prev": {
    "href": "https://api.xvid.com/v1/backtraces/?start=0&limit=2&human=true&show_null=true&sort=created_at&direction=-1"
  }
}

Example Request for Fetching a Specific Backtrace ​

bash
curl -X GET "https://api.xvid.com/v1/backtraces/54761380e4b0fc918f8b8b13?human=true&show_null=true" \
  -H "Authorization: Bearer AUTH_TOKEN"

Example Response for Fetching a Specific Backtrace ​

Success (200 OK) ​

json
{
  "backtrace": {
    "input": {
      "input_name": "uploads/uNy8MH9vImbrJlK-R9zygHotKIvpTK2e/DX3_QLtB0fw-.mp4"
    },
    "pipeline": {
      "id": "547f3eede4b025bcbff38657",
      "href": "https://api.xvid.com/v1/pipelines/547f3eede4b025bcbff38657"
    },
    "file": {
      "id": "5e4ea4b9eac702dfc8bc104d",
      "href": "https://api.xvid.com/v1/files/5e4ea4b9eac702dfc8bc104d"
    },
    "job": {
      "id": "5e4ea4c1e4b0328e395247a3"
    },
    "application": {
      "id": "54e89692e4b069d88de25f8f"
    },
    "extracted_data": [
      {
        "autograph_tag": "rtzu",
        "access_stats": [
          {
            "ip_address": "90.191.11.199",
            "ip_country": "Estonia",
            "ip_type": "UNK",
            "user_agent": "Mozilla/5.0 (Windows NT 6.3; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/86.0.4240.75 Safari/537.36",
            "accept_language": "en-US,en;q=0.9,de;q=0.8,de-AT;q=0.7,de-DE;q=0.6,de-LI;q=0.5,de-CH;q=0.4",
            "first_accessed_at": 1604484332000,
            "percentage_obtained": "100%",
            "highest_resolution": "352p",
            "streaming_only": "no"
          }
        ]
      }
    ],
    "status": "SUCCESS",
    "percentage_completed": 100,
    "error_msg": null,
    "error_code": null,
    "finished_at": 1604484852659,
    "version": 1,
    "user": {
      "id": "547f3eede4b025bcbff38655",
      "href": "https://api.xvid.com/v1/users/547f3eede4b025bcbff38655"
    },
    "created_at": 1604484365237,
    "updated_at": 1604484365237,
    "id": "5fa27d0de4b074c775b7d107",
    "href": "https://api.xvid.com/v1/backtraces/5fa27d0de4b074c775b7d107"
  }
}

Error Responses ​

400 Bad Request ​

json
{
  "error": {
    "error_code": "0x0050001",
    "error_message": "Invalid Input"
  }
}

403 Forbidden ​

json
{
  "error": {
    "error_code": "0x0000003",
    "error_message": "Invalid access token"
  }
}

404 Not Found ​

json
{
  "error": {
    "error_code": "0x0300007",
    "error_message": "Backtrace does not exist"
  }
}

500 Internal Server Error ​

json
{
  "error": {
    "error_code": "0x0000001",
    "error_message": "Internal Error"
  }
}