License.features

From Safe Creative API
Revision as of 08:38, 5 May 2010 by w>Jguillo
Jump to navigation Jump to search

Returns a localized list of license features and their applicable values.

You can use this to present the user an explanation of the features for different licenses.

Info

  • Component name: license.features
  • Signature: No signature required
  • Timestamp: Ztime not required

Parameters

  • locale: Locale for feature names

Returns

  • features
    • feature
      • code: Feature code as it apperas in the license features list (see user.licenses)
      • name: Feature full description
      • shortname: Feature name
      • values: Applicable values
        • value: One of YES, YES_WITH_RESTRICTIONS, INHERITANCE, NO, NOT_APPLICABLE (see user.licenses)

Sample

REQUEST:

https://api.safecreative.org/v2/
?component=license.features
&locale=en

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?> <features>

 <feature> 
   distribution 
   <name>Work can be copied and distributed</name> 
   <shortname>Distribution</shortname> 
   <values> 
     <value>YES</value> 
     <value>YES_WITH_RESTRICTIONS</value> 
     <value>NO</value> 
     <value>NOT_APPLICABLE</value> 
   </values> 
 </feature> 
 <feature> 
   commercial 
   <name>Commercial use of this work is allowed</name> 
   <shortname>Commercial</shortname> 
   <values> 
     <value>YES</value> 
     <value>YES_WITH_RESTRICTIONS</value> 
     <value>NO</value> 
     <value>NOT_APPLICABLE</value> 
   </values> 
 </feature> 
 <feature> 
   derivations 
   <name>Derived works can be produced</name> 
   <shortname>Derivative</shortname> 
   <values> 
     <value>YES</value> 
     <value>YES_WITH_RESTRICTIONS</value> 
     <value>INHERITANCE</value> 
     <value>NO</value> 
     <value>NOT_APPLICABLE</value> 
   </values> 
 </feature> 
 <feature> 
   recognition 
   <name>Author must be recognized</name> 
   <shortname>Recognition</shortname> 
   <values> 
     <value>YES</value> 
     <value>NO</value> 
     <value>NOT_APPLICABLE</value> 
   </values> 
 </feature> 
 <feature> 
   timelimited 
   <name>License has a limited period of application</name> 
   <shortname>Time limited</shortname> 
   <values> 
     <value>YES</value> 
     <value>NOT_APPLICABLE</value> 
   </values> 
 </feature> 

</features>