User.licenses

From Safe Creative API
Revision as of 07:48, 5 May 2010 by w>Jguillo (Created page with 'Returns a paginated list of licenses which are available to the user. = Info = * '''Component name:''' user.licenses * '''Signature:''' Requires signature using the authkey'…')
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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

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

Sample

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>