Work.rightsholders.add

From Safe Creative API
Revision as of 06:36, 6 May 2010 by w>Jguillo
Jump to navigation Jump to search

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

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/
?authkey=1i5g2aaf2bz09lyo867cuimqg
&component=work.rightsholders.add
&mail=sholmes%40baker.fake
&roles=AUTHOR%2CRIGHTS_OWNER
&canedit=1
&workcode=1004200146116
&ztime=1271749848300
&signature=2975fb609c151e46ca26bbaabab16732288b126a

RESPONSE:

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