API docs by Redocly

DocumentConverter HTTP API (8.23.0)

Download OpenAPI specification:Download

Open-Xchange GmbH: info@open-xchange.com URL: https://www.open-xchange.com

Documentation of the Open-Xchange GmbH DocumentConverter HTTP API.

DocumentConverter

The DocumentConverter service module.

beginconvert

Starting the stateful retrieval of single pages from a source document.

query Parameters
url
string

TODO (KA)

targetformat
string
Default: "jpeg"
Enum: "jpeg" "png"

TODO (KA)

nocache
string
Default: false
Enum: false true

TODO (KA)

cacheonly
string
Default: false
Enum: false true

TODO (KA)

async
string
Default: false
Enum: false true

TODO (KA)

priority
string
Default: "background"
Enum: "background" "low" "medium" "high" "inastant"

TODO (KA)

autoscale
string
Default: false
Enum: false true

TODO (KA)

hidechanges
string
Default: false
Enum: false true

TODO (KA)

hidecomments
string
Default: false
Enum: false true

TODO (KA)

userrequest
string
Default: false
Enum: false true

TODO (KA)

Request Body schema: multipart/form-data
file
string <binary>

Responses

Response samples

Content type
application/json
{
  • "async": true,
  • "errorcode": 0,
  • "cachehash": "string",
  • "inputfilehash": "string",
  • "locale": "string",
  • "jobid": "string",
  • "pagecount": 0,
  • "originalPageCount": 0,
  • "pagenumber": 0,
  • "mimetype": "string",
  • "extension": "string",
  • "passwordprotected": true,
  • "maxsourcesize": true,
  • "unsupported": true,
  • "result": "string"
}

convert

Stateless conversion of a source document to a target format. The conversion result data is given back as an archive in the file case as well as in the JSON case.

query Parameters
async
string
Default: false
Enum: false true

TODO (KA)

autoscale
string
Default: false
Enum: false true

TODO (KA)

cacheonly
string
Default: false
Enum: false true

TODO (KA)

firstpageonly
string
Default: false
Enum: false true

TODO (KA)

hidechanges
string
Default: false
Enum: false true

TODO (KA)

hidecomments
string
Default: false
Enum: false true

TODO (KA)

nocache
string
Default: false
Enum: false true

TODO (KA)

priority
string
Default: "background"
Enum: "background" "low" "medium" "high" "inastant"

TODO (KA)

returntype
string
Default: "json"
Enum: "json" "file"

TODO (KA)

targetformat
string
Default: "jpeg"
Enum: "jpeg" "png"

TODO (KA)

url
string

TODO (KA)

userrequest
string
Default: false
Enum: false true

TODO (KA)

Request Body schema: multipart/form-data
file
string <binary>

Responses

Response samples

Content type
No sample

endconvert

Finishing of a stateful document conversion, which needs to be made after the last 'getpage' call. The jobId returned from the initial 'beginconvert' call is to be used for this final call.

query Parameters
jobid
string

TODO (KA)

nocache
string
Default: false
Enum: false true

TODO (KA)

cacheonly
string
Default: false
Enum: false true

TODO (KA)

async
string
Default: false
Enum: false true

TODO (KA)

Responses

Response samples

Content type
application/json
{
  • "async": true,
  • "errorcode": 0,
  • "cachehash": "string",
  • "inputfilehash": "string",
  • "locale": "string",
  • "jobid": "string",
  • "pagecount": 0,
  • "originalPageCount": 0,
  • "pagenumber": 0,
  • "mimetype": "string",
  • "extension": "string",
  • "passwordprotected": true,
  • "maxsourcesize": true,
  • "unsupported": true,
  • "result": "string"
}

getpage

Retrieving a single page after an initial stateful 'beginconvert' call. The jobId returned from the initial 'beginconvert' call is to be used for each one of these calls.

query Parameters
jobid
string

TODO (KA)

pangenumber
integer <int16>

TODO (KA)

returntype
string
Default: "json"
Enum: "json" "file"

TODO (KA)

nocache
string
Default: false
Enum: false true

TODO (KA)

cacheonly
string
Default: false
Enum: false true

TODO (KA)

async
string
Default: false
Enum: false true

TODO (KA)

Responses

Response samples

Content type
No sample

getpreview

Stateless retrieval of a preview from a file as an image.

query Parameters
url
string

TODO (KA)

targetformat
string
Default: "jpeg"
Enum: "jpeg" "png"

TODO (KA)

returntype
string
Default: "json"
Enum: "json" "file"

TODO (KA)

nocache
string
Default: false
Enum: false true

TODO (KA)

cacheonly
string
Default: false
Enum: false true

TODO (KA)

async
string
Default: false
Enum: false true

TODO (KA)

priority
string
Default: "background"
Enum: "background" "low" "medium" "high" "inastant"

TODO (KA)

hidechanges
string
Default: false
Enum: false true

TODO (KA)

hidecomments
string
Default: false
Enum: false true

TODO (KA)

userrequest
string
Default: false
Enum: false true

TODO (KA)

Request Body schema: multipart/form-data
file
string <binary>

Responses

Response samples

Content type
No sample

getthumbnail

Stateless retrieval of a thumbnail preview from a file as an image.

query Parameters
url
string

TODO (KA)

targetformat
string
Default: "jpeg"
Enum: "jpeg" "png"

TODO (KA)

returntype
string
Default: "json"
Enum: "json" "file"

TODO (KA)

nocache
string
Default: false
Enum: false true

TODO (KA)

cacheonly
string
Default: false
Enum: false true

TODO (KA)

async
string
Default: false
Enum: false true

TODO (KA)

priority
string
Default: "background"
Enum: "background" "low" "medium" "high" "inastant"

TODO (KA)

hidechanges
string
Default: false
Enum: false true

TODO (KA)

hidecomments
string
Default: false
Enum: false true

TODO (KA)

userrequest
string
Default: false
Enum: false true

TODO (KA)

Request Body schema: multipart/form-data
file
string <binary>

Responses

Response samples

Content type
No sample

rconvert

Specific flavour of a source document conversion to a specified target format, offering additional functionality.

query Parameters
method
string
Default: "convert"
Enum: "convert" "queryavailability" "beginpageconversion" "getconversionpage" "endpageconversion"

TODO (KA)

jobtype
string
Default: "pdf"
Enum: "graphic" "html" "image" "imagetransformation" "odf" "ooxml" "pdf" "pdf2grf" "pdf2html" "pdf2svg" "pdfenctest"

TODO (KA)

jobid
string

TODO (KA)

priority
string
Default: "background"
Enum: "background" "low" "medium" "high" "inastant"

TODO (KA)

locale
string

TODO (KA)

cachehash
string

TODO (KA)

remotecachehash
string

TODO (KA)

filtershortname
string

TODO (KA)

inputtype
string

TODO (KA)

pixelwidth
integer <int32>

TODO (KA)

pixelheight
integer <int32>

TODO (KA)

mimetype
string

TODO (KA)

pangerange
string

TODO (KA)

pangenumber
integer <int16>

TODO (KA)

ziparchive
string
Default: false
Enum: false true

TODO (KA)

infofilename
string

TODO (KA)

nocache
string
Default: false
Enum: false true

TODO (KA)

cacheonly
string
Default: false
Enum: false true

TODO (KA)

async
string
Default: false
Enum: false true

TODO (KA)

imageresolution
integer <int16>

TODO (KA)

imagescaletype
string
Default: "contain"
Enum: "contain" "cover"
remoteurl
string

TODO (KA)

url
string

TODO (KA)

returntype
string
Default: "json"
Enum: "json" "file"

TODO (KA)

autoscale
string
Default: false
Enum: false true

TODO (KA)

hidechanges
string
Default: false
Enum: false true

TODO (KA)

hidecomments
string
Default: false
Enum: false true

TODO (KA)

userrequest
string
Default: false
Enum: false true

TODO (KA)

Request Body schema: multipart/form-data
file
string <binary>

Responses

Response samples

Content type
No sample

root Request

Getting the current status of the DocumentConverter server as text/html response.

query Parameters
metrics
string
Default: "false"

Set to "yes", if a metrics summary should be returned.

Responses

status Request

Getting the current status of the DocumentConverter server as application/json response.

query Parameters
metrics
string
Default: "false"

Set to "yes", if a metrics summary should be returned.

Responses

Response samples

Content type
application/json
{
  • "server": {
    }
}