How to: Register a work as a copyright info provider: Difference between revisions
w>Jguillo No edit summary |
w>Jguillo No edit summary |
||
Line 5: | Line 5: | ||
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 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. | ||
Copyright holders names are provided through parameters '' | Copyright holders names are provided through parameters '''rightsholderfirstname''N''''', '''rightsholdermiddlename''N''''' and '''rightsholderlastname''N'''''. | ||
= Example = | = Example = |
Revision as of 14:47, 20 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 leverage 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 three separate parameters: authorfirstnameN, authormiddlenameN and authorlastnameN. You can provide more than one author as authorfirstname1, authorfirstname2, etc. The number of provided first, middle and last names must be the same.
Copyright holders names are provided through parameters rightsholderfirstnameN, rightsholdermiddlenameN and rightsholderlastnameN.
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 &authorfirstname1=Jacob &authormiddlename1= &authorlastname1=Grimm &authorfirstname2=Wilhelm &authormiddlename2= &authorlastname2=Grimm &noncekey=2fq865ow3gq97lli5a56hx5dw &ztime=1274361089949 &signature=529d6bd32d2535ace060ce7b0a314303fc031b92
RESPONSE:
<?xml version="1.0" encoding="UTF-8"?> <workregistry> <code>1005200147325</code> </workregistry>