Work.rightsholders.remove: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
(Created page with '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 …')
 
m (5 revisions imported)
 
(4 intermediate revisions by 2 users not shown)
Line 8: Line 8:
= Info =
= Info =


* '''Component name:''' work.rightsholders.add
* '''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]]
* '''Authorization level:''' MANAGE
* '''Authorization level:''' MANAGE
* '''API trust level''': Standard


= Parameters =
= Parameters =
Line 26: Line 27:
* '''confirm-url:''' Confirmation URL as sent in the mail
* '''confirm-url:''' Confirmation URL as sent in the mail


= Sample =
= Example =


REQUEST:
REQUEST:


  <nowiki>https://api.safecreative.org/v2/</nowiki>
  <nowiki>https://api.safecreative.org/v2/</nowiki>
  ?'''component'''=work.rightsholders.add
  ?'''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>