Movedigital.licenses.getListPublic

From MoveDigital Docs

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/ and should include the following arguments

method (required) - Must be set to: movedigital.licenses.getListPublic
licensetype (optional) - Can be set to a specific license type (eg. licenses_cc, licenses_cc_sampling, licenses_cplus_prodigem)
licenseid (optional, if set 'licensetype' must be set) - Can be set to return the specific sub-id of a particular licensetype
licenseattribution (optional, if set 'licensetype' must be set to 'licenses_cc') - Can be set to specify the type of licenses_cc licenses to return
licensecommercialuse (optional, if set 'licensetype' must be set to 'licenses_cc') - Can be set to specify the type of licenses_cc licenses to return
licensemodifications (optional, if set 'licensetype' must be set to 'licenses_cc') - Can be set to specify the type of licenses_cc licenses to return
licensesample (optional, if set 'licensetype' must be set to 'licenses_cc_sample') - Can be set to specify which licenses_cc_sample license to return

[edit]

Example Responses

Success

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="ok">
	<method>movedigital.licenses.getListPublic</method>
	<format>rest</format>
	<licenses>
		<licensegrouping type="licenses_cc">
			<license licenseid="1" licensename="Creative Commons" 
				 licensesubname="NoDerivs-NonCommercial 1.0" 
				 licenseurl="http://creativecommons.org/licenses/nd-nc/1.0/" 
				 licenseattribution="no" licensecommercialuse="no" licensemodifications="no" />
			<license licenseid="2" licensename="Creative Commons" 
				 licensesubname="Attribution-NonCommercial-NoDerivs 2.0" 
				 licenseurl="http://creativecommons.org/licenses/by-nc-nd/2.0/" 
				 licenseattribution="yes" licensecommercialuse="no" licensemodifications="no" />
			<license licenseid="3" licensename="Creative Commons" 
				 licensesubname="Attribution-NoDerivs 2.0" 
				 licenseurl="http://creativecommons.org/licenses/by-nd/2.0/" 
				 licenseattribution="yes" licensecommercialuse="yes" licensemodifications="no" />
			<license licenseid="4" licensename="Creative Commons" 
				 licensesubname="Attribution-NonCommercial 2.0" 
				 licenseurl="http://creativecommons.org/licenses/by-nc/2.0/" 
				 licenseattribution="yes" licensecommercialuse="no" licensemodifications="yes" />
			<license licenseid="5" licensename="Creative Commons" 
				 licensesubname="Attribution-NonCommercial-ShareAlike 2.0" 
				 licenseurl="http://creativecommons.org/licenses/by-nc-sa/2.0/" 
				 licenseattribution="yes" licensecommercialuse="no" 
				 licensemodifications="share-alike" />
			<license licenseid="6" licensename="Creative Commons" licensesubname="Attribution 2.0" 
				 licenseurl="http://creativecommons.org/licenses/by/2.0/" licenseattribution="yes" 
				 licensecommercialuse="yes" licensemodifications="yes" />
			<license licenseid="7" licensename="Creative Commons" 
				 licensesubname="Attribution-ShareAlike 2.0" 
				 licenseurl="http://creativecommons.org/licenses/by-sa/2.0/" 
				 licenseattribution="yes" licensecommercialuse="yes" 
				 licensemodifications="share-alike" />
			<license licenseid="8" licensename="Creative Commons" licensesubname="NoDerivs 1.0" 
				 licenseurl="http://creativecommons.org/licenses/nd/1.0/" licenseattribution="no" 
				 licensecommercialuse="yes" licensemodifications="no" />
			<license licenseid="9" licensename="Creative Commons" 
				 licensesubname="Public Domain Dedication" 
				 licenseurl="http://creativecommons.org/licenses/publicdomain/" 
				 licenseattribution="no" licensecommercialuse="yes" licensemodifications="yes" />
			<license licenseid="10" licensename="Creative Commons" licensesubname="ShareAlike 1.0" 
				 licenseurl="http://creativecommons.org/licenses/sa/1.0/" licenseattribution="no" 
				 licensecommercialuse="yes" licensemodifications="share-alike" />
			<license licenseid="11" licensename="Creative Commons" licensesubname="NonCommercial 1.0" 
				 licenseurl="http://creativecommons.org/licenses/nc/1.0/" licenseattribution="no" 
				 licensecommercialuse="no" licensemodifications="yes" />
			<license licenseid="12" licensename="Creative Commons" 
				 licensesubname="NonCommercial-ShareAlike 1.0" 
				 licenseurl="http://creativecommons.org/licenses/nc-sa/1.0/" 
				 licenseattribution="no" licensecommercialuse="no" 
				 licensemodifications="share-alike" />
		</licensegrouping>
		<licensegrouping type="licenses_cc_sampling">
			<license licenseid="1" licensename="Creative Commons" licensesubname="Sampling 1.0" 
				 licenseurl="http://creativecommons.org/licenses/sampling/1.0/" 
				 licensesample="Sampling 1.0" />
			<license licenseid="2" licensename="Creative Commons" licensesubname="Sampling Plus 1.0" 
				 licenseurl="http://creativecommons.org/licenses/sampling+/1.0/" 
				 licensesample="Sampling Plus 1.0" />
			<license licenseid="3" licensename="Creative Commons" 
				 licensesubname="Noncommercial Sampling Plus 1.0" 
				 licenseurl="http://creativecommons.org/licenses/nc-sampling+/1.0/" 
				 licensesample="Noncommercial Sampling Plus 1.0" />
		</licensegrouping>
		<licensegrouping type="licenses_cplus_movedigital">
			<license licenseid="1" licensename="Copyright Plus MoveDigital" licensesubname="1.0" 
				 licenseurl="http://www.movedigital.com/copyright_plus_prodigem/" />
		</licensegrouping>
	</licenses>
	<messages>
	</messages>
</rsp>

Error

<?xml version="1.0" encoding="utf-8" ?>
<rsp stat="fail">
	<method>movedigital.licenses.getListPublic</method>
	<errors>
		<error code="106" msg="When providing an 'attribution', 'commercial_use' or 'modification' value,
					you must set the licensetype to 'licenses_cc'." />
	</errors>
</rsp>

[edit]