Work.list: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
No edit summary
m (4 revisions imported)
 
(One intermediate revision by one other user not shown)
Line 13: Line 13:
* '''page:''' Page number
* '''page:''' Page number
* '''locale:''' Locale for work type, license names,...
* '''locale:''' Locale for work type, license names,...
== Filters ==
The following parameters allow to filter the results:
* '''state:''' Work state, as specified in [[About works]]
* '''tag:''' Works with the specified tag
* '''worktype''N'':''' (multivalue) Codes of the work types to include in the results (as returned in [[work.types]])
* '''worktypegroup:''' Work type group code (as returned in [[work.types.tree]])
* '''license:''' License code (e.g. copyright)
* '''fromdate:''' Works registered beginning on this date
* '''todate:''' Works registered up to this date
* '''filter:''' Text filter, returns works containing this text in their codes, titles, excerpts or tags
== Order ==
* '''sortfield:''' Work list can be ordered by ''code''(default) or ''title''


<nowiki>* Required parameter</nowiki>
<nowiki>* Required parameter</nowiki>

Latest revision as of 08:07, 7 May 2021

Returns a user's registered works list.

Info

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

Parameters

  • authkey*: User's authorization key
  • ztime*: Z-Timestamp
  • page: Page number
  • locale: Locale for work type, license names,...

Filters

The following parameters allow to filter the results:

  • state: Work state, as specified in About works
  • tag: Works with the specified tag
  • worktypeN: (multivalue) Codes of the work types to include in the results (as returned in work.types)
  • worktypegroup: Work type group code (as returned in work.types.tree)
  • license: License code (e.g. copyright)
  • fromdate: Works registered beginning on this date
  • todate: Works registered up to this date
  • filter: Text filter, returns works containing this text in their codes, titles, excerpts or tags

Order

  • sortfield: Work list can be ordered by code(default) or title

* Required parameter

Returns

A paginated list of work elements:

  • work
    • code: Safe Creative work code
    • title: Work title
    • entrydate: Work registration date
    • state: Work state (see About works)

Example

REQUEST:

https://api.safecreative.org/v2/
?component=work.list
&authkey=1i5g2aaf2bz09lyo867cuimqg
&page=1
&ztime=1271749847821
&signature=40c6cabb341a463e4d824e702b1c4606692fa293

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<listpage>
  <recordtotal>2</recordtotal>
  <pagetotal>1</pagetotal>
  <list>
    <work>
      <code>1003030120266</code>
      <title>memorymanagement_whitepaper</title>
      <entrydate>2010-03-03T08:17:15Z</entrydate>
      <state>REGISTERED</state>
    </work>
    <work>
      <code>1003030120259</code>
      <title>Big times</title>
      <entrydate>2010-03-03T08:16:30Z</entrydate>
      <state>REGISTERED</state>
    </work>
  </list>
</listpage>