Movedigital.files.editFile

From MoveDigital Docs

While most of the parameters of this method call are required, it functions okay if you leave them blank. However, if they are left blank, these blank values will overwrite any previously saved values associated with the file.

Table of contents

1 Arguments

2 Example Responses

3 Error Codes

4 Live REST Demo

[edit]

Arguments

Calls are POSTed to http://www.movedigital.com/services/rest/ should include the following arguments

method (required) - Must be set to: movedigital.files.editFile
userid (required) - The userid of the MoveDigital account.
sessionid (required) - The sessionid for the current session.
session (required) - The session value for the associated sessionid.
fileid (required) - The id of the file you wish to edit.
categoryid (optional) - The id of the category you wish to associate with this file.
filetags (optional) - The comma separated list of tags you wish to associate with this file.
filetitle (optional) - The title of this file.
filedescription (optional) - The description for this file.
bindedits (optional) - Whether edits to this entry should affect other entries in the folder (eg. 'self' edits only this entry, 'license' edits only this entry and binds the license info to all entries in the folder, 'folder' binds all edits to all entries in the folder). If no value is given, it defaults to 'self'.
licensetype (optional) - The type of license for this torrent (eg. 'licenses_cc', 'licenses_cc_sampling', 'licenses_cplus_movedigital', 'licenses_other').
- licenses_cc
  - licenseattribution (optional) - The attribution value (eg. 'yes', 'no') if this is a Creative Commons (licenses_cc) type license.
  - licensecommercialuse (optional) - The commercial use value (eg. 'yes', 'no') if this is a Creative Commons (licenses_cc) type license.
  - licensemodifications (optional) - The modifications value (eg. 'yes', 'no', 'share-alike') if this is a Creative Commons (licenses_cc) type license.
- licenses_cc_sampling
  - licensesample (optional) - The sampling value (eg. 'Sampling 1.0', 'Sampling Plus 1.0', 'Noncommercial Sampling Plus 1.0') if this is a Creative Commons Sampling (licenses_cc_sampling) type license.
- licenses_other
  - licenseothername (optional) - Required if you are manually setting your own license (licensetype = licenses_other). This is the name of the license you are manually using.
  - licenseotherurl (optional) - Required if you are manually setting your own license (licensetype = licenses_other). This is the URL of the license you are manually using.

[edit]

Example Responses

Success

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
	<method>movedigital.files.editFile</method>
	<format>rest</format>
	<messages>
		<message msg="Successfully edited file." />
	</messages>
</rsp>

Error

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
	<method>movedigital.files.editFile</method>
	<errors>
		<error code="83" msg="This file is unable to be found." />
	</errors>
</rsp>

[edit]