Work.rights.register - Revision history

Adminwiki: /* Info */

2024-09-19T08:51:15Z

Info

← Older revision		Revision as of 08:51, 19 September 2024
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

Adminwiki: /* Info */

2024-09-19T08:50:47Z

Info

← Older revision		Revision as of 08:50, 19 September 2024
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

Adminwiki: 2 revisions imported

2021-05-07T08:07:39Z

2 revisions imported

← Older revision	Revision as of 08:07, 7 May 2021
(No difference)

w>Jguillo: /* Parameters */

2016-03-31T12:01:11Z

Parameters

← Older revision		Revision as of 12:01, 31 March 2016
Line 21:		Line 21:
	* '''percent:''' Percent of authorship or rights the user has over the work. Allows up to two decimals.		* '''percent:''' Percent of authorship or rights the user has over the work. Allows up to two decimals.

	For RIGHTS inscriptions, the following parameters ~~can be specified~~:		For RIGHTS inscriptions, the following parameters also apply:
	* '''rights*:''' Textual description of the rights the user is inscribing.		* '''rights*:''' Textual description of the rights the user is inscribing.
	* '''begindate:''' When do the inscribed rights begin to apply.		* '''begindate:''' When do the inscribed rights begin to apply.

w>Jguillo: Created page with '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 inscri…'

2016-03-31T12:00:33Z

Created page with '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 inscri…'

New page

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 can be specified:
* '''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,...)

<nowiki>*</nowiki> Required parameter

= Returns =
* '''restvalueresponse'''
** '''state:''' ready

= Example =

REQUEST:

<nowiki>https://api.safecreative.org/v2/</nowiki>
?'''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:

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

[[Category:API component]]