Re: First alpha release of Europeana's Annotation API

Hi, Hugo–

Congratulations and thanks! It's great to see uptake of our specs!

A few comments inline…

On 11/18/15 11:33 AM, Hugo Manguinhas wrote:
> Hi all,
>
> We (the Europeana Foundation) finally have our annotation API in a state
> that we can share with the group!
>
> The endpoint is available at
> http://test-annotations.europeana.eu/annotation

I'm getting a 404 for that URL in the browser.

Even if it's only intended as an endpoint for HTTP publications, there 
probably should be some user-readable response (and content) there, 
right? (I don't know the answer to this…)

Note that this URL (and all the others you mention) works fine:

http://test-annotations.europeana.eu/

> and you can use for the
> moment “apidemo” as apikey. A user friendly interface of the API is
> available at http://test-annotations.europeana..eu/docs/index.html
> <http://test-annotations.europeana.eu/docs/index.html>, btw we use a
> tool called Swagger for generating the REST interface and
> documentation... also, if you would like to see a real annotation coming
> from the HistoryPin.org plaform, here is the link:
> http://test-annotations.europeana.eu/annotation/historypin/136290?wskey=apidemo
> .

Is it within the scope of your project to actually expose the 
annotations to end-users? For example, will the body of the "bus" 
annotation in your HistoryPin example be available on the "target" site 
[1]? Or on HistoryPin itself?

Or are you just intending to serve as a repository for other annotation 
clients to consume and display your content?

Either way is interesting, and I'm curious which direction you're taking.


> The version that is live follows the version prior to the one from 15th
> October of the Web Annotation Data Model and the recently published spec
> of the W3C Annotation Protocol... btw, we will be revising our
> implementation soon to comply with the latest version. Besides the
> general CRUD methods it has an additional method for search method for
> discovering annotations. All methods have an additional flavour using
> format extensions instead of the Accept Header. We did this to be
> compliant with our other APIs which do not follow this practice.
>
> Finally, if you try to create an annotation in the server, please note
> that we have only implemented some simple scenarios for now and will be
> progressively supporting more complex ones as we start to agree on how
> they should be represented… we followed a more restrictive approach so
> that we can make sure that annotations coming from different client
> applications are uniformly represented in the server and therefore shown
> in our portal.

Makes sense.

Again, this is very exciting!

[1] 
http://www.europeana.eu/portal/record/9200257/BibliographicResource_3000055619928.html

Regards–
–Doug≠

Received on Wednesday, 18 November 2015 17:50:40 UTC