How to: Register a work as a copyright info provider: Difference between revisions
w>Jguillo No edit summary |
w>Jguillo No edit summary |
||
| Line 3: | Line 3: | ||
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 | Authors names must be provided in the multivalue parameter: '''author''N''''', so you can provide more than one author as ''author1'', ''author2'', etc. Authors names have the following syntax: ''FirstName|MiddleName|LastName'' (or ''FirstName||LastName'' if author has no middle name). Both first and last names are required. | ||
Copyright holders names are provided through | Copyright holders names are provided through parameter '''rightsholder''N''''' in the same way. | ||
= Example = | = Example = | ||
| Line 21: | Line 21: | ||
&worktype=narrative | &worktype=narrative | ||
&tags=fairy+tale | &tags=fairy+tale | ||
& | &author1=Jacob||Grimm | ||
&author2=Wilhelm||Grimm | |||
& | |||
&noncekey=2fq865ow3gq97lli5a56hx5dw | &noncekey=2fq865ow3gq97lli5a56hx5dw | ||
&ztime=1274361089949 | &ztime=1274361089949 | ||
Revision as of 11:02, 25 May 2010
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. Authors names have the following syntax: FirstName|MiddleName|LastName (or FirstName||LastName if author has no middle name). Both first and last names are required.
Copyright holders names are provided through parameter rightsholderN in the same way.
Example
Registering "Snow White" from the Brothers Grimm:
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>