Work.rightsholders.confirm

From Safe Creative API
Revision as of 08:07, 7 May 2021 by Adminwiki (talk | contribs) (2 revisions imported)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

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>