License.features: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
(Created page with '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 = *…')
 
w>Jguillo
No edit summary
Line 29: Line 29:
RESPONSE:
RESPONSE:


<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
'''<features>'''
<features>  
   '''<feature>'''
   <feature>  
     '''<nowiki><code></nowiki>'''distribution'''<nowiki></code></nowiki>'''
     <code>distribution</code>  
     '''<name>'''Work can be copied and distributed'''</name>'''
     <name>Work can be copied and distributed</name>  
     '''<shortname>'''Distribution'''</shortname>'''
     <shortname>Distribution</shortname>  
     '''<values>'''
     <values>  
       '''<value>'''YES'''</value>'''
       <value>YES</value>  
       '''<value>'''YES_WITH_RESTRICTIONS'''</value>'''
       <value>YES_WITH_RESTRICTIONS</value>  
       '''<value>'''NO'''</value>'''
       <value>NO</value>  
       '''<value>'''NOT_APPLICABLE'''</value>'''
       <value>NOT_APPLICABLE</value>  
     '''</values>'''
     </values>  
   '''</feature>'''
   </feature>  
   '''<feature>'''
   <feature>  
     '''<nowiki><code></nowiki>'''commercial'''<nowiki></code></nowiki>'''
     <code>commercial</code>  
     '''<name>'''Commercial use of this work is allowed'''</name>'''
     <name>Commercial use of this work is allowed</name>  
     '''<shortname>'''Commercial'''</shortname>'''
     <shortname>Commercial</shortname>  
     '''<values>'''
     <values>  
       '''<value>'''YES'''</value>'''
       <value>YES</value>  
       '''<value>'''YES_WITH_RESTRICTIONS'''</value>'''
       <value>YES_WITH_RESTRICTIONS</value>  
       '''<value>'''NO'''</value>'''
       <value>NO</value>  
       '''<value>'''NOT_APPLICABLE'''</value>'''
       <value>NOT_APPLICABLE</value>  
     '''</values>'''
     </values>  
   '''</feature>'''
   </feature>  
   '''<feature>'''
   <feature>  
     '''<nowiki><code></nowiki>'''derivations'''<nowiki></code></nowiki>'''
     <code>derivations</code>  
     '''<name>'''Derived works can be produced'''</name>'''
     <name>Derived works can be produced</name>  
     '''<shortname>'''Derivative'''</shortname>'''
     <shortname>Derivative</shortname>  
     '''<values>'''
     <values>  
       '''<value>'''YES'''</value>'''
       <value>YES</value>  
       '''<value>'''YES_WITH_RESTRICTIONS'''</value>'''
       <value>YES_WITH_RESTRICTIONS</value>  
       '''<value>'''INHERITANCE'''</value>'''
       <value>INHERITANCE</value>  
       '''<value>'''NO'''</value>'''
       <value>NO</value>  
       '''<value>'''NOT_APPLICABLE'''</value>'''
       <value>NOT_APPLICABLE</value>  
     '''</values>'''
     </values>  
   '''</feature>'''
   </feature>  
   '''<feature>'''
   <feature>  
     '''<nowiki><code></nowiki>'''recognition'''<nowiki></code></nowiki>'''
     <code>recognition</code>  
     '''<name>'''Author must be recognized'''</name>'''
     <name>Author must be recognized</name>  
     '''<shortname>'''Recognition'''</shortname>'''
     <shortname>Recognition</shortname>  
     '''<values>'''
     <values>  
       '''<value>'''YES'''</value>'''
       <value>YES</value>  
       '''<value>'''NO'''</value>'''
       <value>NO</value>  
       '''<value>'''NOT_APPLICABLE'''</value>'''
       <value>NOT_APPLICABLE</value>  
     '''</values>'''
     </values>  
   '''</feature>'''
   </feature>  
   '''<feature>'''
   <feature>  
     '''<nowiki><code></nowiki>'''timelimited'''<nowiki></code></nowiki>'''
     <code>timelimited</code>  
     '''<name>'''License has a limited period of application'''</name>'''
     <name>License has a limited period of application</name>  
     '''<shortname>'''Time limited'''</shortname>'''
     <shortname>Time limited</shortname>  
     '''<values>'''
     <values>  
       '''<value>'''YES'''</value>'''
       <value>YES</value>  
       '''<value>'''NOT_APPLICABLE'''</value>'''
       <value>NOT_APPLICABLE</value>  
     '''</values>'''
     </values>  
   '''</feature>'''
   </feature>  
'''</features>'''
</features>


[[Category:API component]]
[[Category:API component]]

Revision as of 08:38, 5 May 2010

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>

Retrieved from "https://www.safecreative.org/mw/index.php?title=License.features&oldid=332"