Work.rightsholders.list - Revision history

Adminwiki: 5 revisions imported

2021-05-07T08:07:40Z

5 revisions imported

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

w>Jguillo at 08:46, 14 May 2010

2010-05-14T08:46:30Z

← Older revision		Revision as of 08:46, 14 May 2010
Line 42:		Line 42:
	**** '''request-date''': Date when this request was sent		**** '''request-date''': Date when this request was sent

	= ~~Sample~~ =		= Example =

	REQUEST:		REQUEST:

w>Jguillo at 07:36, 6 May 2010

2010-05-06T07:36:44Z

← Older revision		Revision as of 07:36, 6 May 2010
Line 9:		Line 9:
	* '''Timestamp:''' ZTime is not required		* '''Timestamp:''' ZTime is not required
	* '''Authorization level:''' GET		* '''Authorization level:''' GET
			* '''API trust level''': Standard

	= Parameters =		= Parameters =

w>Jguillo at 06:58, 6 May 2010

2010-05-06T06:58:54Z

← Older revision		Revision as of 06:58, 6 May 2010
Line 46:		Line 46:

	<nowiki>https://api.safecreative.org/v2/</nowiki>		<nowiki>https://api.safecreative.org/v2/</nowiki>
	?'''~~authkey~~'''=~~1i5g2aaf2bz09lyo867cuimqg~~		?'''component'''=work.rightsholders.list
	&'''~~component~~'''=~~work.rightsholders.list~~		&'''authkey'''=1i5g2aaf2bz09lyo867cuimqg
	&'''workcode'''=1004200146116		&'''workcode'''=1004200146116
	&'''signature'''=2975fb609c151e46ca26bbaabab16732288b126a		&'''signature'''=2975fb609c151e46ca26bbaabab16732288b126a

w>Jguillo at 06:58, 6 May 2010

2010-05-06T06:58:20Z

← Older revision		Revision as of 06:58, 6 May 2010
Line 69:		Line 69:
	<rightsholder>		<rightsholder>
	<usercode>0909160000830</usercode>		<usercode>0909160000830</usercode>
	<name>~~James~~ Watson</name>		<name>John Watson</name>
	<can-edit>false</can-edit>		<can-edit>false</can-edit>
	<state>REJECTED</state>		<state>REJECTED</state>
Line 78:		Line 78:
	<rightsholder>		<rightsholder>
	<usercode>0909160000830</usercode>		<usercode>0909160000830</usercode>
	<name>~~James~~ Watson</name>		<name>John Watson</name>
	<can-edit>true</can-edit>		<can-edit>true</can-edit>
	<state>ACTIVE</state>		<state>ACTIVE</state>

w>Jguillo: Created page with 'Returns a list of the copyright holders of a work. 'Shared works management' professional service must be active for the authorizing user. = Info = * '''Component name:''' wor…'

2010-05-06T06:57:19Z

Created page with 'Returns a list of the copyright holders of a work. 'Shared works management' professional service must be active for the authorizing user. = Info = * '''Component name:''' wor…'

New page

Returns a list of the copyright holders of a work.

'Shared works management' professional service must be active for the authorizing user.

= Info =

* '''Component name:''' work.rightsholders.list
* '''Signature:''' Requires signature using the authorization key's private key
* '''Timestamp:''' ZTime is not required
* '''Authorization level:''' GET

= Parameters =

* '''authkey*:''' Authorization key
* '''workcode*:''' Work code

<nowiki>*</nowiki> Required parameter

= Returns =

* '''rightsholders'''
** '''rightsholder'''
*** '''usercode''': Copyright holder's Safe Creative code
*** '''name''': Full name, pseudonym or mail address (if not confirmed yet)
*** '''can-edit''': Can edit the work (true|false)
*** '''state''': Rights sharing state. One of the following:
**** ''PENDING:'' A rights sharing request has been sent, but it has not been answered
**** ''ACTIVE:'' This rights sharing has been confirmed
**** ''REJECTED:'' This rights sharing request has been rejected by the recipient
**** ''INACTIVE:'' This rights sharing has been cancelled
**** ''INVALID:'' This rights sharing has been deemed invalid (e.g. recipient was already a copyright holder of the work)
*** '''entrydate''': Date of acceptance of rights holding
*** '''roles''': List of roles of this copyright holder
**** '''role''': One of AUTHOR, RIGHTS_HOLDER, INFORMER
*** '''pending-request''': There is a pending request to this copyright holder
**** '''confirm-url''': Confirmation URL sent with this request
**** '''request-usercode''': Safe Creative code of the user who made this request
**** '''request-state''': State to apply to this rights sharing if request is confirmed. Can be one of the following:
***** ''ACTIVE:'' It's a request for rights sharing
***** ''INACTIVE:'' It's a request to cancel the copyright holder rights
**** '''request-date''': Date when this request was sent

= Sample =

REQUEST:

<nowiki>https://api.safecreative.org/v2/</nowiki>
?'''authkey'''=1i5g2aaf2bz09lyo867cuimqg
&'''component'''=work.rightsholders.list
&'''workcode'''=1004200146116
&'''signature'''=2975fb609c151e46ca26bbaabab16732288b126a

RESPONSE:

<pre>
<?xml version="1.0" encoding="UTF-8"?>
<rightsholders>
<rightsholder>
<usercode>0702034400200</usercode>
<name>Sherlock Holmes</name>
<can-edit>true</can-edit>
<state>ACTIVE</state>
<entrydate>2010-03-03T08:16:30Z</entrydate>
<roles>
<role>AUTHOR</role>
<role>RIGHTS_OWNER</role>
</roles>
</rightsholder>
<rightsholder>
<usercode>0909160000830</usercode>
<name>James Watson</name>
<can-edit>false</can-edit>
<state>REJECTED</state>
<roles>
<role>RIGHTS_OWNER</role>
</roles>
</rightsholder>
<rightsholder>
<usercode>0909160000830</usercode>
<name>James Watson</name>
<can-edit>true</can-edit>
<state>ACTIVE</state>
<entrydate>2010-05-06T06:53:56Z</entrydate>
<roles>
<role>RIGHTS_OWNER</role>
</roles>
</rightsholder>
</rightsholders>
</pre>

[[Category:API component]]