laurilopes / node-openload

An openload.co API handler

node-openload

An Openload API wrapper for Node.JS using Promises.

• Author: Sascha Zarhuber
• GitHub: @saschazar21
• Twitter: @saschazar
• Source: https://github.com/saschazar21/node-openload
• Issues: https://github.com/saschazar21/node-openload/issues
• Releases: https://github.com/saschazar21/node-openload/releases

Prerequisites

• Node.JS v6 and above
• Openload API key (available after registration)

Install

npm install --save node-openload

Usage

Create an instance by using the following configuration:

const openload = require('node-openload');
const ol = openload({
  api_login: YOUR-API-LOGIN-HERE,
  api_key: YOUR-API-KEY-HERE,
});

Functions

Below the available functions are listed. The structure of the returned object may be looked up at the API documentation.
By default, this module returns only the result property from the API response.

Sample function call:

ol.getAccountInfo()
  .then(info => console.log(info));   // Prints account info

getAccountInfo()

Returns information about your account.

getDownloadTicket(file)

Returns a download ticket, needed for actually downloading desired file afterwards.

file: The ID of your requested file.

Caution:

• Sometimes the response also returns a captcha_url property holding an image link in the result.
• In addition a 509: Bandwidth usage exceeded error might be returned, this is the API's fault, not the fault of this module. Then a file download is not possible at this time.

getDownloadLink(obj)

Returns a download link for the requested file.

obj: Object containing data for the download:

{
  file:             // mandatory
  ticket:           // mandatory
  captcha_response:
}

• obj.file: The ID of your requested file.
• obj.ticket: The previously generated ticket.
• captcha_response: The response to the retrieved captcha image (only if there was a captcha_url returned with the download ticket).

getDownload(file)

Combines getDownloadTicket(file) and getDownloadLink(obj).
Either returns download link, or, if Captcha is necessary, returns response of getDownloadTicket(file).

getFileInfo(file)

Returns info about given file id.

file: might consist of an Array or a string of comma-seperated file IDs. Max 50 IDs allowed.

deleteFile(file)

Deletes files based on given file id.

file: might consist of an Array or a string of comma-seperated file IDs. Max 50 IDs allowed.

listFolder(folder)

List contents (folders, files) of given folder id.

folder: The folder ID you want the contents listed of. (not required)

getFolder(folder)

Duplicate of listFolder(folder).

remoteUpload(obj)

Upload a file from a remote URL.

obj: Object containing data for the upload:

{
  url:             // mandatory
  folder:
  headers:
}

• obj.url: The URL to the resource you want to upload.
• obj.folder: The folder ID you would like to upload to. (not required)
• obj.headers: If the desired resource needs special HTTP headers, please look up the API documentation.

remoteUploadStatus(obj)

Check the upload status of a previously initiated remote upload.

obj: Object containing data for the upload:

{
  id:
  limit:
}

• obj.id: The remote upload ID. (not required)
• obj.limit: Limit results (Default 5, Max. 100). (not required)

upload(obj, cb)

Perform an upload of a local file.

obj: Object containing data for the upload:

{
  file:             // mandatory
  folder:
  filename:
  contentType:
}

• obj.file: A buffer or the local path of your desired file.
• obj.folder: The folder ID you want to upload to. (not required)
• obj.filename: The file's name. (only required if using a buffer)
• obj.contentType: The file's content type. (only required if using a buffer)

cb: Callback function to display the upload progress in the form of got's uploadProgress event.

getSplashImage(file)

Get thumbnail of file

file File ID for thumbnail:

Errors

All provided functions return a Promise. If an error occurs, the module rejects the Promise using an Error object containing short informational message.

Issues

Please report any bugs or issues to the issues section.

Contribution

Contributors welcome!
Please fork this repository, open a pull request and drop me a line on twitter.

Contributions to this project

• @Stradi added getSplashImage(). This was released in v2.1.0.
• @SrPatinhas suggested to update got due to incompatibilities when using node-openload with Electron. This was released in v2.1.1.
• @berstend suggested also setting a filename if uploading file path instead of buffer. This was released in v2.2.0

Credits

• @sindresorhus for got and hasha
• @alexindigo for form-data
• @tootallnate for debug
• @dasilvacontin for mocha
• @chaijs for chai

Disclaimer

I am not affiliated with Openload and/or its owners in any way. This source code is the result of my very own interests and is either written by me and/or any contributor listed in the contributors section. Therefore I am not liable for any content users of this source code are processing in any way.
If you feel there is something wrong with this repository or the source code it contains, please open up a new issue.

License

MIT

Milestones

• Add missing API endpoints (Convert a file, Show running converts, Show failed converts)
• Find a better way to handle captcha responses

Version history

• 2.2.0 - @berstend added a PR for setting a filename option for uploads, @SrPatinhas suggested adding upload progress status.
• 2.1.1 - Released a hotfix with updated dependencies due to incompatibilities when using node-openload with Electron. Credits: @SrPatinhas.
• 2.1.0 - @Stradi added getSplashImage().
• 2.0.0 - Refactored v1.0.0, now also supporting buffers as upload content type. Added deleteFile(). Dropped request in favor of got. Added tests using mocha.
• 1.0.0 - Initial version