Work.rightsholders.add: Difference between revisions
Jump to navigation
Jump to search
w>Jguillo Created page with '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…' |
w>Jguillo No edit summary |
||
| Line 26: | Line 26: | ||
= Returns = | = Returns = | ||
* confirm-url: Confirmation URL as sent in the mail to the new copyright holder | * '''confirm-url:''' Confirmation URL as sent in the mail to the new copyright holder | ||
= Sample = | = Sample = | ||
Revision as of 06:34, 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
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>