Work.rightsholders.confirm: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
(Created page with 'Confirms or rejects an authorship or rights holder request added by work.rightholders.add. If the request is for a rights holder, either the authorizing user or the request …')
 
w>Jguillo
(No difference)

Revision as of 12:43, 14 July 2016

Confirms or rejects an authorship or rights holder request added by work.rightholders.add.

If the request is for a rights holder, either the authorizing user or the request user must have the 'Rights inscription' professional service.

Info

  • Component name: work.rightsholders.confirm
  • 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
  • code*: Request code
  • accept*: 1 to accept the request, 0 to reject it
  • rejectreason: Reason for rejecting the request (required in case of rejection)

* Required parameter

Returns

  • restvalueresponse
    • state: ready


Example

REQUEST:

https://api.safecreative.org/v2/
?component=work.rightsholders.confirm
&authkey=1i5g2aaf2bz09lyo867cuimqg
&accept=1
&ztime=1271749848300
&signature=2975fb609c151e46ca26bbaabab16732288b126a

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<restvalueresponse><state>ready</state></restvalueresponse>