User.licenses: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
No edit summary
w>Jguillo
No edit summary
Line 37: Line 37:
* '''NOT_APPLICABLE''': Feature has no meaning for this license
* '''NOT_APPLICABLE''': Feature has no meaning for this license


= Sample =  
= Example =  


REQUEST
REQUEST

Revision as of 08:43, 14 May 2010

Returns a paginated list of licenses which are available to the user.

Info

  • Component name: user.licenses
  • Signature: Requires signature using the authkey's private key
  • Timestamp: Requires ztime parameter
  • Authorization level: GET
  • API trust level: Standard

Parameters

  • authkey*: The user's authorization key
  • ztime*: Z-Timestamp
  • page: Page to return (default 1)
  • locale: Locale for license names

* Required parameter

Returns

Paginated list of license elements:

  • license
    • code: License code
    • name: License name
    • shortname: License abbreviation
    • url: URL to the license full text
    • features: License features
      • recognition: Work original authorship must be recognised
      • distribution: Work can be copied and distributed
      • derivations: New works can be created based upon this work
      • timelimited: License has a limited period of application, which must be specified when registering the work (using these kind of licenses is a professional service)
      • commercial: Work can be used for commercial purposes

License features can have one of the following values:

  • YES: Feature is applicable
  • NO: Feature is not applicable
  • YES_WITH_RESTRICTIONS: Feature is applicable with some conditions imposed by the license text
  • INHERITANCE: (Only for derivations feature) Derivative works must be distributed with the same license
  • NOT_APPLICABLE: Feature has no meaning for this license

Example

REQUEST

https://api.safecreative.org/v2/
?authkey=1i5g2aaf2bz09lyo867cuimqg
&component=user.licenses
&page=1
&ztime=1271749823888
&signature=0c740f90e64eac87502c4a0630363ad65fbad7ec

RESPONSE

<?xml version="1.0" encoding="UTF-8"?>
<listpage>
   <recordtotal>218</recordtotal>
   <pagetotal>9</pagetotal>
   <list>
     <license>
       <code>copyright</code>
       <name>All rights reserved</name>
       <shortname>(c)</shortname>
       <url>http://www.safecreative.org/license/copyright</url>
       <features>
         <recognition>NOT_APPLICABLE</recognition>
         <distribution>NO</distribution>
         <derivations>NO</derivations>
         <timelimited>NOT_APPLICABLE</timelimited>
         <commercial>NO</commercial>
       </features>
     </license>
     [...]
     <license>
       <code>http://creativecommons.org/licenses/by/2.5/my/</code>
       <name>Attribution 2.5 Malaysia</name>
       <shortname>CC by 2.5 my</shortname>
       <url>http://creativecommons.org/licenses/by/2.5/my/legalcode</url>
       <jurisdiction>my</jurisdiction>
       <features>
         <recognition>YES</recognition>
         <distribution>YES</distribution>
         <derivations>YES</derivations>
         <timelimited>NOT_APPLICABLE</timelimited>
         <commercial>YES</commercial>
       </features>
     </license>
   </list>
</listpage>