Work.rights.register: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
Tag: Reverted
Tag: Manual revert
 
Line 10: Line 10:
* '''Signature''': Requires signature using the authorization key's private key
* '''Signature''': Requires signature using the authorization key's private key
* '''Timestamp:''' Requires [[ztime parameter]]
* '''Timestamp:''' Requires [[ztime parameter]]
* '''Nonce key:''' Requires a [[nonce key]]
* '''Authorization level:''' MANAGE
* '''Authorization level:''' MANAGE
* '''API trust level''': Standard
* '''API trust level''': Standard

Latest revision as of 08:51, 19 September 2024

Registers a copyright inscription for a work.

This allows the user to add an inscription of partial authorship or other rights to an existing work registration.

'Rights inscriptions' professional service must be active for the authorizing user.

Info

  • Component name: work.rights.register
  • Signature: Requires signature using the authorization key's private key
  • Timestamp: Requires ztime parameter
  • Authorization level: MANAGE
  • API trust level: Standard

Parameters

  • authkey*: Authorization key
  • ztime*: Z-Timestamp
  • workcode*: Code of the registered work to which the inscription will be made
  • type*: Type of inscription. May be AUTHORSHIP or RIGHTS
  • percent: Percent of authorship or rights the user has over the work. Allows up to two decimals.

For RIGHTS inscriptions, the following parameters also apply:

  • rights*: Textual description of the rights the user is inscribing.
  • begindate: When do the inscribed rights begin to apply.
  • enddate: When do the inscribed rights cease to apply.
  • jurisdictions: On which jurisdictions (countries, geographic zones) do the inscribed rights apply.
  • rightswindow: For which kind of media do the rights apply (e.g. TV broadcast, paperback edition,...)

* Required parameter

Returns

  • restvalueresponse
    • state: ready

Example

REQUEST:

https://api.safecreative.org/v2/
?component=work.rights.register
&authkey=1i5g2aaf2bz09lyo867cuimqg
&workcode=1004200146116
&type=RIGHTS
&rights=Distribution+and+reproduction
&begindate=2016-01-01'T'00:00:00'Z'
&enddate=2018-12-31'T'23:59:59'Z'
&jurisdictions=Worldwide
&rightswindow=Web+streaming
&ztime=1271749851064
&signature=26ecbbf2e886483516a42314979323db5cb69804

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<restvalueresponse>
  <state>ready</state>
</restvalueresponse>