User.licenses

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>