How to: Register a work as a copyright info provider: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Jguillo
No edit summary
m (14 revisions imported)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
Safe Creative partners can register third party works as copyright information providers. This can be useful, for example, for a library to register works in the public domain. Such works can be submitted to the Safe Creative Copyright Registry services to leverage its search and semantic capabilities.
Safe Creative partners can register third party works as copyright information providers. This can be useful, for example, for a library to register works in the public domain. Such works can be submitted to the Safe Creative Copyright Registry services to take advantage of its search and semantic capabilities.


To register a work as a copyright information provider, [[work.register]] component must be called with '''userinformer=1'''
To register a work as a copyright information provider, [[work.register]] component must be called with '''userinformer=1'''


Authors names must be provided in three separate parameters: '''authorfirstname''N''''', '''authormiddlename''N''''' and '''authorlastname''N'''''. You can provide more than one author as ''authorfirstname1'', ''authorfirstname2'', etc. The number of provided first, middle and last names must be the same.
Authors names must be provided in the multivalue parameter: '''author''N''''', so you can provide more than one author as ''author1'', ''author2'', etc.  


Copyright holders names are provided through parameters ''rightsholderfirstnameN'', ''rightsholdermiddlenameN'' and ''rightsholderlastnameN''.
Author names have the following syntax:
FirstName|MiddleName|LastName


'''NOTE: This is a beta functionality and can only be tested in arena environment'''
First and last names are required. Middle name may be empty.
 
Copyright holders names are provided through parameter '''rightsholder''N''''' in the same way.


= Example =
= Example =


Registering "Snow White" from the Brothers Grimm:
Registering "Snow White" from the Grimm Brothers:


REQUEST:
REQUEST:
Line 23: Line 26:
&worktype=narrative
&worktype=narrative
&tags=fairy+tale
&tags=fairy+tale
&authorfirstname1=Jacob
&author1=Jacob||Grimm
&authormiddlename1=
&author2=Wilhelm||Grimm
&authorlastname1=Grimm
&authorfirstname2=Wilhelm
&authormiddlename2=
&authorlastname2=Grimm
&noncekey=2fq865ow3gq97lli5a56hx5dw
&noncekey=2fq865ow3gq97lli5a56hx5dw
&ztime=1274361089949
&ztime=1274361089949

Latest revision as of 08:07, 7 May 2021

Safe Creative partners can register third party works as copyright information providers. This can be useful, for example, for a library to register works in the public domain. Such works can be submitted to the Safe Creative Copyright Registry services to take advantage of its search and semantic capabilities.

To register a work as a copyright information provider, work.register component must be called with userinformer=1

Authors names must be provided in the multivalue parameter: authorN, so you can provide more than one author as author1, author2, etc.

Author names have the following syntax:

FirstName|MiddleName|LastName 

First and last names are required. Middle name may be empty.

Copyright holders names are provided through parameter rightsholderN in the same way.

Example

Registering "Snow White" from the Grimm Brothers:

REQUEST:

http://api.safecreative.org/v2/
?component=work.register
&authkey=Bb7NTK14QGeHjluE3vziqQ
&userinformer=1
&title=Snow+White
&text=Once+upon+a+time...
&worktype=narrative
&tags=fairy+tale
&author1=Jacob||Grimm
&author2=Wilhelm||Grimm
&noncekey=2fq865ow3gq97lli5a56hx5dw
&ztime=1274361089949
&signature=529d6bd32d2535ace060ce7b0a314303fc031b92

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<workregistry>
  <code>1005200147325</code>
</workregistry>