Work.rightsholders.add: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
No edit summary
w>Jguillo
No edit summary
Line 34: Line 34:


  <nowiki>https://api.safecreative.org/v2/</nowiki>
  <nowiki>https://api.safecreative.org/v2/</nowiki>
  ?'''authkey'''=1i5g2aaf2bz09lyo867cuimqg
  ?'''component'''=work.rightsholders.add
  &'''component'''=work.rightsholders.add
  &'''authkey'''=1i5g2aaf2bz09lyo867cuimqg
  &'''mail'''=sholmes%40baker.fake
  &'''mail'''=sholmes%40baker.fake
  &'''roles'''=AUTHOR%2CRIGHTS_OWNER
  &'''roles'''=AUTHOR%2CRIGHTS_OWNER
Line 46: Line 46:


<pre>
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<?xml version="1.0" encoding="UTF-8"?>
<confirm-url>https://www.safecreative.org/shareconfirm/8b017250f9d74615951b94ed4d492384</confirm-url>
<confirm-url>https://www.safecreative.org/shareconfirm/8b017250f9d74615951b94ed4d492384</confirm-url>

Revision as of 06:55, 6 May 2010

Add a user as a copyright holder of a work.

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

A mail will be sent to the provided address asking for confirmation. This method returns the confirmation URL sent to the mail address.

Info

  • Component name: work.rightsholders.add
  • Signature: Requires signature using the authorization key's private key
  • Timestamp: Requires ztime parameter
  • Authorization level: MANAGE

Parameters

  • authkey*: Authorization key
  • ztime*: Z-Timestamp
  • workcode*: Work code
  • mail*: E-mail address of the copyright holder
  • roles*: Comma-separated list of any of the following values: AUTHOR, RIGHTS_OWNER
  • canedit*: 1 if user will be able to edit the work
  • private: 1 if user will not appear in the work public authors / right holders list

* Required parameter

Returns

  • confirm-url: Confirmation URL as sent in the mail to the new copyright holder

Sample

REQUEST:

https://api.safecreative.org/v2/
?component=work.rightsholders.add
&authkey=1i5g2aaf2bz09lyo867cuimqg
&mail=sholmes%40baker.fake
&roles=AUTHOR%2CRIGHTS_OWNER
&canedit=1
&workcode=1004200146116
&ztime=1271749848300
&signature=2975fb609c151e46ca26bbaabab16732288b126a

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<confirm-url>https://www.safecreative.org/shareconfirm/8b017250f9d74615951b94ed4d492384</confirm-url>