Work.rightsholders.remove: Difference between revisions
Jump to navigation
Jump to search
w>Jguillo No edit summary |
m 5 revisions imported |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 8: | Line 8: | ||
= Info = | = Info = | ||
* '''Component name:''' work.rightsholders. | * '''Component name:''' work.rightsholders.remove | ||
* '''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]] | ||
| Line 27: | Line 27: | ||
* '''confirm-url:''' Confirmation URL as sent in the mail | * '''confirm-url:''' Confirmation URL as sent in the mail | ||
= | = Example = | ||
REQUEST: | REQUEST: | ||
<nowiki>https://api.safecreative.org/v2/</nowiki> | <nowiki>https://api.safecreative.org/v2/</nowiki> | ||
?'''component'''=work.rightsholders. | ?'''component'''=work.rightsholders.remove | ||
&'''authkey'''=1i5g2aaf2bz09lyo867cuimqg | &'''authkey'''=1i5g2aaf2bz09lyo867cuimqg | ||
&'''workcode'''=1004200146116 | &'''workcode'''=1004200146116 | ||
Latest revision as of 08:07, 7 May 2021
Requests to remove a user as author or copyright holder of a work.
'Shared rights management' professional service must be active for the authorizing user.
A mail will be sent to the user for confirmation. This method returns the confirmation URL sent to the user.
Info
- Component name: work.rightsholders.remove
- 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*: Work code
- usercode*: Safe Creative code of the user to remove
* Required parameter
Returns
- confirm-url: Confirmation URL as sent in the mail
Example
REQUEST:
https://api.safecreative.org/v2/ ?component=work.rightsholders.remove &authkey=1i5g2aaf2bz09lyo867cuimqg &workcode=1004200146116 &usercode=0909160000830 &ztime=1271749848300 &signature=2975fb609c151e46ca26bbaabab16732288b126a
RESPONSE:
<?xml version="1.0" encoding="UTF-8"?> <confirm-url>https://arena.safecreative.org/shareconfirm/cc2d830e15ee44c38eb81d1157869f15</confirm-url>